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Production Note 


This book was produced with the VAX DOCUMENT electronic publishing 
system, a software tool developed and sold by Digital. In this system, 
writers use an ASCII text editor to create source files containing text and 
English-like code; this code labels the structural elements of the document, 
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which runs on the VMS operating system, interprets the code to format 
the text, generate a table of contents and index, and paginate the entire 
document. Writers can print the document on the terminal or line printer, 
or they can use Digital-supported devices, such as the LNO3 laser printer 
and PostScript printers (PrintServer 40 or LNO3R ScriptPrinter), to 
produce a typeset-quality copy containing integrated graphics. 
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Preface 


This manual contains information about the following: 

e The VMS Version 5.3 installation procedure 

¢ The VMS Version 5.3 upgrade procedure 

e Installing VMS DECwindows software 

If you are going to install the VMS operating system, follow the 
installation procedure in this guide. Refer to the VMS installation and 
operations guide for your VAX computer for information specific to your 
computer. Information specific to your computer includes such tasks as 


turning on the system, booting standalone BACKUP, and booting the new 
system disk. 


If you are going to upgrade to Version 5.3 of the VMS operating system, 
follow the upgrade procedure in this guide. 


Intended Audience 


This manual is intended for system managers, operators, and users of the 
VMS operating system. Read this manual before you install, upgrade, or 
use Version 5.3 of the VMS operating system. 


Document Structure 
This manual contains the following chapters: 


¢ Chapter 1 describes what happens during an installation or an 
upgrade. | 


e Chapter 2 describes how to install Version 5.3 of the VMS operating 
system. 


¢ Chapter 3 lists the tasks you should perform after you install the 
VMS operating system. 


¢ Chapter 4 contains cautions, restrictions, notes, and suggestions about 
upgrading your VAX computer system. 


¢ Chapter 5 tells you how to prepare your system for an upgrade. 


¢ Chapter 6 describes the procedures for upgrading a VAXcluster 
environment. 


¢ Chapter 7 describes the procedures for upgrading a single computer 
system. 


e Chapter 8 lists the tasks you should perform after the upgrade. 


¢ Chapter 9 describes the VMS User Environment Test Package (UETP) 
and how to use it to test the system. 


¢ Chapter 10 describes how to start and customize VMS DECwindows 
software. 


xiii 
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Appendix A describes how to boot from SYSF on the different types of 
VAX computers. 


Appendix B lists the files in the VMS library and optional save sets. 
Appendix C lists VMS DECwindows files. 


Appendix D outlines layered product support for Version 5.3 of the 
VMS operating system. 


Appendix E contains release notes for the VAX 8200 computer. 


Appendix F contains information on how to install VMS DECwindows 
sofware using DECW$TAILOR (after an initial VMS installation). 





Associated Documents 


The following documents may be useful: 


The installation and operations guide for your VAX computer—Provides 
information that you will need during an installation or upgrade, such 
as booting and device naming procedures. 


VMS Version 5.3 New Features Manual—Describes new software 
features of VMS Version 5.3. 


VMS VAXcluster Manual—Describes the procedures for setting up and 
managing VAXcluster configurations. 


VMS Version 5.3 Release Notes—Provides notes on the various aspects 
of the VMS operating system. 


VMS License Management Utility Manual—Provides information about 
registering and managing licenses on a VMS system. 


The hardware manuals supplied with your VAX computer provide 
detailed information about system hardware. 





Conventions 


xiv 


The following conventions are used in this manual: 


Ctri/x A sequence such as Ctri/x indicates that you must 


[] 


hold down the key labeled Ctrl while you press 
another key or a pointing device button. 


A vertical ellipsis indicates the omission of items from 
a code example or command format; the items are 
omitted because they are not important to the topic 
being discussed. 


In format descriptions, brackets indicate that whatever 
is enclosed within the brackets is optional; you can 
select none, one, or all of the choices. (Brackets are 
not, however, optional in the syntax of a directory 
name in a file specification or in the syntax of a 
substring specification in an assignment statement.) 


red ink 


boldface text 


UPPERCASE TEXT 


numbers 
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Red ink indicates information that you must enter from 
the keyboard or a screen object that you must choose 
or click on. For online versions of the book, user input 
is shown in bold. 


Boldface text represents the introduction of a new 
term or the name of an argument, an attribute, or a 
reason. 


Boldface text is also used to show user input in online 
versions of the book. 


Uppercase letters indicate that you must enter a 
command (for example, enter OPEN/READ), or they 
indicate the name of a routine, the name of a file, the 
name of a file protection code, or the abbreviation for 
a system privilege. 

Unless otherwise noted, all numbers in the text are 
assumed to be decimal. Nondecimal radixes—binary, 
octal, or hexadecimal—are explicitly indicated. 


This manual often refers to products by their abbreviated names. For 
example, the VAX 8200, VAX 8250, VAX 8300, and VAX 8350 computers 
are referred to collectively as the VAX 8200, 8250, 8300, 8350. The 
MicroVAX 2000 computer is referred to as the MicroVAX 2000, and so 


on. 
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1 The Installation and Upgrade Procedures 


This chapter describes what happens during the installation and upgrade 
procedures. It also tells whether you should do an installation or an 
upgrade, and refers you to the appropriate documentation. 


CAUTION: You cannot install or upgrade to Version 5.3 of the VMS operating 
system on the following VAX computers and system disks: 


e MicroVAX I, VAXstation I, and VAX 11/725 
¢ RKO07, RLO2, RC25, RD51, and RD52 system disks 


1.1 What Happens During an Installation: 


When you install the VMS operating system, the installation procedure 
does the following: 


e Initializes the system disk, erasing its contents 
¢ Creates a system directory structure 
e Transfers the VMS files from the distribution media to the system disk 


Use the installation procedure under the following conditions: 


e If your VAX computer is new (it has never had any version of the 
operating system running on it). 


e If your VAX computer is running a version of the VMS operating 
system and you want to erase the entire contents of the system disk 
(both VMS and user files). 


e Ifyou are running the VMS operating system, but cannot upgrade. 
For example, if you changed the names of system directories on the 
system disk, the upgrade procedure will not work correctly. You can 
either restore the system disk to its original directory structure, or you 
can re-install the VMS operating system. 


CAUTION: The installation procedure initializes the system disk, erasing its 
contents. For this reason, use the installation procedure only on 
new VAX computers or if you want to overwrite the contents of the 
system disk. | | 


If you are installing the VMS operating system, go to Chapter 2. 
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The Installation and Upgrade Procedures 
1.2 What Happens During an Upgrade 


What Happens During an Upgrade 


When you upgrade the VMS operating system, the upgrade procedure does 
the following: 


e Makes room for the upgrade by purging and deleting some VMS files 
but leaves all the user files intact 


e Transfers the VMS files from the distribution media to the system disk 
e Merges the old VMS files and the new VMS files 
e Cleans up files and structures used only during the upgrade 


In most cases, you can use the upgrade procedure to obtain a higher 
version. The upgrade procedure does not initialize the system disk. 


CAUTION: The upgrade procedure will not work correctly if you have 
changed the names of system directories on your system disk. 
Restore your VMS system disk to a standard directory structure 
before attempting an upgrade. 


If you are upgrading your system, go to(Chapter. 4? 





Part! 


Part | contains information about installing Version 5.3 of the VMS operating 
system. 
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2 Installing the VMS Operating System and DECwindows 
Software 


This chapter describes installing Version 5.3 of the VMS operating system 
and VMS DECwindows software. Use this chapter in conjunction with 
the VMS installation and operations guide for your VAX computer. The 
VMS installation and operations guide has information specific to your 
computer, such as turning on the system, booting standalone BACKUP, 
and booting the new system disk. 


CAUTION: You cannot install or upgrade to Version 5.3 of the VMS operating 
system on the following VAX computers and system disks: 


e MicroVAX I, VAXstation I, and VAX 11/725 
e RKO07, RLO2, RC25, RD51, and RD52 system disks 


The instructions refer to the source-drive and the target-drive where: 
e The source-drive is the drive that holds the distribution kit. 
e The target-drive is the drive that holds the system disk. 


CAUTION: The software installation procedure overwrites the contents of 
the system disk. Use the installation procedure only if your VAX 
computer is new, or if you want to destroy the contents of the 
system disk. If your system disk contains files that you want 
to save, you should upgrade to the new version of VMS. For an 
overview of the upgrade procedure, see Chapter 4. 





2.1 Before You Start 
Before you install the VMS operating system, do the following: 


e Make sure the hardware has been installed and checked for proper 
operation. For detailed information on the hardware, see the hardware 
manual for your VAX computer. | 


e Make sure you have all the items listed on the bill of materials in the 
VMS distribution kit. If your kit is incomplete, notify Digital Software 
Supply, and request priority shipment of any missing items. 


CAUTION: Do not attempt to use VMSINSTAL with OPTIONS G to transfer 
VMS and VMS DECwindows save sets to another media type. If 
you perform an installation using such a kit, you will produce 
an unusable system. 


¢ The VMS save sets must be in the [000000] directory on the system 
disk. The save sets are in this directory on all Digital-supplied 
distribution kits. If you have to move the VMS save sets, they must be 
in the [000000] directory, or the installation will fail. 
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Installing the VMS Operating System and DECwindows Software 
2.1 Before You Start 


¢ Record the installation procedure on either a hardcopy terminal or 
a printer attached to the console terminal. If you do not do this, the 
screen messages will be lost. You will need a transcript in case there 
is a problem during the installation. 


e Read the “Before Installing VMS” chapter in the VMS installation and 
operations guide for your VAX computer before you do the installation. 
This chapter contains important information, specific to your VAX 
computer. 


e Ifyou are installing the VMS operating system on a VAX computer in a 
VAXcluster environment, determine whether you want a Cl-only, local 
area, or mixed-interconnect configuration. For a complete description 
of configurations, see the VMS VAXcluster Manual. Depending on the 
type of configuration, you need to obtain the following information 
from either the network or VAXcluster manager: 


— ClI-Only Configuration: Obtain the allocation class value, the 
DECnet node name, and DECnet node address for the computer. 


— Local Area and Mixed-Interconnect Configurations: Obtain the 
allocation class value, the DECnet node name, and DECnet node 
address for the computer. You also need the cluster group number 
and password. 


e Ifyou have a VAX computer that uses console media, you also need the 
most recent version of the console media. For example, if you have a 
VAX—11/780, you need the most recent version of the console RX01. 


During the installation procedure, the VMS files are transferred from the 
distribution kit to the system disk. You also have the option of installing 
VMS DECwindows software. The following is the list of tasks in the 
installation procedure: 


Turning on the system 

Preparing the disk and tape drives 

Booting standalone BACKUP 

Creating the system disk 

Installing VMS DECwindows software (optional) 
Joining a VAXcluster (optional) 

7 Setting passwords and running AUTOGEN 
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To install the VMS operating system, follow the directions in this chapter. 
At certain points you will need to refer to the VMS installation and 
operations guide for your VAX computer. 





2.2 Turning On the System 
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If necessary, read the section “Turning on the System” in the VMS | 
installation and operations guide for your VAX computer. Once the system 
is turned on, go to Section 2.3 in this chapter to prepare the disk and tape 
drives. | | 
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2.3 Preparing the Disk and Tape Drives 


2.3 Preparing the Disk and Tape Drives 


Set up the disk and tape drives you use during the installation by doing 
the following: 


1 


Decide which drive will hold the distribution tape or disk and which 
drive will hold the system disk. Determine the device names for each 
drive. Write these names on a piece of paper. You will need this 
information throughout the installation. If you need more information 
about determining the device names for your system, refer to the VMS 
installation and operations guide for your VAX computer. 


Do not place the distribution media in the drive at this point. 


Follow this step only if the source-drive or target-drive is attached to 
an Hierarchical Storage Controller (HSC). Otherwise, go to step 3. 


Make sure that both the CI and HSC devices are turned on, and are 
on line. Obtain the HSC name from the system manager, or use the 
following procedure: 


a. Press CTRL/C at the HSC console terminal. 


b. Enter the following command at the HSC> prompt and press 
RETURN: 


HSC> SHOW SYSTEM 
The information displayed includes the name of the HSC. For 
example: | 


19-APR-1990 15:00:00.00 Boot:19-Apr-1990 11231:11.41 Up: 51:00 
Version V350 System ID: %X000000011 Name: KRUP 


DISK allocation class = 1 TAPE allocation class = 0 
Start command file Disabled 


SETSHO - Program Exit 
For more information, see the HSC User’s Guide. 


Place a scratch disk in the drive for the system disk (unless the system 
disk is fixed). | 


Spin up the disk that will be the system disk but do not write-protect 
it. 

To boot standalone BACKUP on a VAX 8800 series computer, go to 
Section 2.4. 


To boot standalone BACKUP on any other VAX computer, go to 
Section 2.5. 
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2.4 Booting Standalone BACKUP On a VAX 8800 Series Computer 


Follow the instructions in this section only if you are booting standalone 
BACKUP on a VAX 8800 series computer. If you are booting standalone 
BACKUP on any other VAX computer, go to Section 2.5. 


To boot standalone BACKUP on a VAX 8800 series computer, do the 
following: | 


1 Use the TK50 tape cartridge labeled VMS V5.2 CONSOLE S/A BKUP 
TK50 DEC to copy standalone BACKUP to the hard disk of your your 
console subsystem before beginning the software installation. 


e Ifyou are a new VAX 8800 Series customer, you will find this TK50 
tape cartridge in your software kit. 


e Ifyou are a service update customer, you received this TK50 tape 
cartridge with your VMS Version 5.2 software kit. 


VMS Installation and Operations: VAX 8820, 8830, 8840 contains 
instructions for copying standalone BACKUP to the hard disk of your . 
console subsystem. Digital is not providing a new standalone BACKUP 
kit for VAX 8800 series computers with VMS Version 5.3 because this 
kit has not changed since VMS Version 5.2. 


2 Boot standalone BACKUP from the hard disk of your console 
subsystem, following the instructions in the “Booting Standalone 
BACKUP” section of the VMS Installation and Operations: VAX 8820, 
8830, 8840. After you boot standalone BACKUP, return to this guide 
for the next step in the VMS Version 5.3 installation procedure. 


3 After you boot standalone BACKUP you should see the following 
display: 


SBACKUP-I-IDENT, standalone BACKUP V5.3; the date is 19-APR-1990 15:00 


$ 


4 Go to Section 2.6 in this chapter to create the system disk. 


2.5 Booting Standalone BACKUP 
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Note: Read this note only if your system contains Digital Small Storage 


Interconnect (DSSD disks attached to a KFQSA controller. 
Starting with VMS Version 5.3, you will notice a change in the 
device names for DSSI disks attached to KFQSA controllers. 
Digital implemented this naming change so that the VMS 
operating system could support additional configuration types. 
For more information on supported configurations, see the 
VMS Version 5.3 Release Notes. 


When you boot standalone BACKUP, it will display the devices on 
your system using the new device naming scheme. Use the new 
device names throughout the installation, and after you complete 
the installation. For complete information on the naming 

scheme for DSSI disk attached to KFQSA controllers, see the 
VMS Version 5.3 Release Notes. 
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To boot standalone BACKUP, complete the following steps: 


1 


Each piece of media in the distribution kit has a label that indicates 
its contents. Place the media that contains standalone BACKUP in the 
source-drive. If your kit contains standalone BACKUP on more than 
one piece of media, put the first piece in the source-drive. 


For example, there are two tape cartridges in a TK50 kit. Standalone 
BACKUP is on the same tape cartridge as VMS DECwindows. This 
tape cartridge is labeled VMS V5.3 BIN TK50 2/2 DECWINDOWS 

& S/A BKUP. To start the installation, put this tape cartridge in the 
appropriate drive. 


Follow the instructions in “Booting Standalone BACKUP” in the VMS 
installation and operations guide for your VAX computer. After you 
boot standalone BACKUP, return to this guide for the next step in the 
VMS Version 5.3 installation procedure. 


After you boot standalone BACKUP you should see the following 
display: 


S$BACKUP-I-IDENT, standalone BACKUP V5.3; the date is 19-APR-1990 15:00 


$ 


Note: If you have a tape cartridge kit, remove the VMS DECwindows 


tape cartridge from the drive after you boot standalone 
BACKUP. Put the tape cartridge that contains the VMS 
operating system in the drive. The VMS tape cartridge is 
labeled VMS V5.3 BIN TK50 1/2 VMS BINARY. 


4 Go to Section 2.6 in this chapter to create the system disk. 


2.6 Creating the System Disk 


This section describes the steps for transferring the VMS files from the 
distribution kit to your system disk. The VMS files are stored on the 
distribution kit as three save sets: required, library, and optional, 


Note: The VMS V5.3 magnetic tape kit contains VMS and VMS 
DECwindows software on two tapes. The first tape contains the 
VMS required and library save sets. The second tape contains the 
optional save set and the VMS DECwindows software. 


1 


If you have not already done so, determine the device names for the 
source-drive and the target-drive. Write these names on a piece of 
paper. You will need this information throughout the installation. If 
either the source-drive or the target-drive are connected to an HSC, 
you also need the name of the HSC. 


If you need more information about determining the device names for 
your system, refer to the VMS ee and operations guide for 
your VAX computer. 


1 If the distribution media is a disk, the VMS save sets are in the [0,0] directory. They must be in this 
directory for the installation procedure to work. 
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2 Each piece of media in the distribution kit has a label that indicates its 


3 


contents. Place the media that contains the VMS operating system in 
the source-drive. If your VMS media consists of more than one piece, 
insert the first piece of media in the source-drive. For example, if you 
have a distribution tape cartridge, make sure the tape labeled VMS 
V5.3 BIN TK50 1/2 VMS BINARY is in the source-drive. 


To transfer the VMS required save set to your system disk, enter a 
BACKUP command in the following format: 


$ BACKUP/VERIFY [{hsc-name] source-drive:VMS053.B/SAVE_ SET [hsc-name]target-drive: 


Substitute the appropriate device names for source-drive and target- 
drive. Make sure you put a colon (:) after each device name and 
that you use zeros in the device names and in VMS053. The square 
brackets ([]) indicate that you need the hsc-name only if the device is 
connected to an HSC. 


For example, if your system has the following configuration: 


¢ A source-drive that is a TU80 magnetic tape drive with a device 
name of MSAO. 


¢ A target-drive that is an RA60 disk drive with a device name of 
DJAI. 


Enter the following command and press RETURN: 
$ BACKUP/VERIFY MSAQ:VMS053.B/SAVE_SET DJA1: 
If your system has the following configuration: 


e A source-drive that is a tape cartridge drive with a device name of 
MUC6. 


e A target-drive that is an RA81 disk drive with a device name of 
DUAI and an HSC name of YOURS. 


Enter the following command and press RETURN: 

$ BACKUP/VERIFY MUC6 : VMS053.B/ SAVE_SET YOURSS$DUAI1: 

The procedure transfers the VMS required save set from the 
distribution kit to the system disk.2 The amount of time this takes 


varies depending upon the system you have. During the process the 
procedure displays the following message: 


SBACKUP-I-STARTVERIFY, starting verification pass 


This message indicates that the required save set has been transferred 
to the system disk and the files are being checked for errors. When the 
standalone BACKUP is done checking the files, the procedure displays 
the following message: 


2 The BACKUP command creates a system disk that includes a set of volume parameters provided by 
Digital, including CLUSTER_SIZE (disk access scheme). For more information, see the VMS installation 
and operations guide for your VAX computer. 
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%BACKUP-I-PROCDONE, Operation completed. Processing finished at 19-APR-1990 15:00 
If you do not want to perform another standalone BACKUP operation, 
use the console to halt the system. 


If you do want to perform another standalone BACKUP operation, 
ensure the standalone application volume is online and ready. 


Enter "YES" to continue: 


5 


Note: 


Halt the system and boot the new system disk, as described in the 
installation and operations guide for your VAX computer. After you 
boot the new system disk, return to this guide for the next step in the 
VMS Version 5.3 installation procedure. 


When the boot is complete, the procedure displays a message and asks 
you for the date and time. Enter the date and time using the 24-hour 
clock format and press RETURN. For example: 


VAX/VMS Version BI53=xxx Major version id = 1 Minor version id = 0 
VAX/VMS Version V5.3 Installation Procedure 


Model: VAX 8800 
System device: RA60 
Free blocks: XXXXXX 


* Please enter the date and time (DD-MMM-YYYY HH:MM): 19-APR-1990 15:00 
%SET-I-NEWAUDSERV, identification of new audit server process is 00000027 
%LICENSE-F-EMTLDB, license database contains no license records 
%LICENSE~E~NOAUTH, DEC VAX-VMS use is not authorized on this node 
-%LICENSE-F-NOLICENSE, no license is active for this software product 
~%LICENSE-I-SYSMGR, please see your system manager 

Startup processing continuing... 


$EEEESEEEEEE OPCOM 19-APR-1990 15:00:500.00 %%%%%%%%%%% 


The procedure displays warning messages that the VMS license 
is not registered. Continue with the installation procedure and 
register the VMS license after you finish the installation. For 
more information about registering your licenses, see the 

VMS License Management Utility Manual. 


The procedure asks for the volume label of the system disk. A volume 
label is the name the VMS operating system uses to refer to the 
system disk. You can press RETURN to accept the default volume 
label, VAXVMSRLO53, or you can enter a volume label of your choice. 
The volume label can be 1 to 12 characters long; do not use spaces. 
For example: 

If this system disk is to be used in a cluster with multiple 

system disks, then each system disk must have a unique volume label. 


Any nodes having system disks with duplicate volume labels will fail 
to boot into the cluster. 


You may indicate a volume label of 1 to 12-characters in length. If you 
wish to use the default name of VAXVMSRLO53 just press RETURN in response to 
the next question. 


* Enter the volume label for this system disk [VAXVMSRL0Q53]: SYSDSK 
The procedure asks which drive holds the distribution kit. Enter the 
device name of the source-drive. For example, if the source-drive is a 


tape cartridge drive with a device name of MUAO, enter the following 
and press RETURN: 
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* Enter the name of the drive holding the VMS distribution media: MUAO 
* Is the VMS media ready to be mounted? [N] YES 


The full VMS kit will be installed on this system disk. 
The following (with approximate sizes) will be provided: 


-VMS library - 27500 blocks 
~VMS optional - 9000 blocks 


You can provide DECwindows support now, or you can use the 
DECWSTAILOR utility to provide or remove DECwindows support 
after the installation. 


NOTE: Some media, TK50s in particular, can be very slow when 
tailoring on files. You might want to provide DECwindows 
options now and tailor off unwanted files later. 


* Do you want to provide optional DECwindows support? (Y/N) 


If you do not want to install VMS DECwindows software, type N (for 
NO), press RETURN, and go to step 9. Note that VMS DECwindows 
software is useful, even on a nonworkstation VAX computer, because 
you can run VMS DECwindows applications on a nonworkstation VAX 
computer and display them on a workstation. 


NOTE: If you do not install VMS DECwindows at this time, you can 
install it after the installation using DECW$TAILOR. Please 
note that for TK50 tape cartridges, it is quicker to install VMS 
DECwindows software during the installation than to tailor 
VMS DECwindows after the upgrade. For more information 
about using DECWS$TAILOR to install VMS DECwindows 
software, see Appendix F. a 


If you want to install VMS DECwindows software, do the following: 


a. Type Y (for YES) and press RETURN. The procedure displays the 
following message: 


You can install either the complete DECwindows kit or selected portions 
of it. A complete installation requires 44500 blocks. If you 

want to perform a partial installation, you can choose to install one 
or more of the following DECwindows components: 


~DECwindows device support - 9500 blocks 
-DECwindows applications - 11000 blocks 
~DECwindows programming support - 24000 blocks 


* Do you want to install complete DECwindows support? (Y/N) 


b. To install the complete DECwindows kit, type Y (for YES) and 
press RETURN. The procedure displays the amount of remaining 
disk space, the DECwindows options that will be provided. 


To install selected portions of the VMS DECwindows kit, type N 
(for NO) and press RETURN. The procedure displays information 
about the amount of space you need on the system disk for each 
option. As you choose your options, the procedure calculates the 
amount of space that would be left on the system disk. 


Consider the following before you select the VMS DECwindows 
options that you want to install: 


¢ Device support files—If you are installing VMS DECwindows 
on a VAXstation or in a cluster that includes VAXstations, you 
need these files. Otherwise you do not need them. Please note 
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that if you select the device support files, you automatically get 
the applications files. 


Applications files—VMS DECwindows provides a variety of 
applications including the following: Bookreader, Calculator, 
Calendar, Cardfiler, Clock, DDIF Document Viewer, EVE Text 
Editor, FileView, Mail, Notepad Text Editor, Paint Graphics 
Editor, DECterm, the Session Manager, and the Icon Box. If 
you are installing VMS DECwindows on a VAXstation, you 
need these files. They are also useful on a nonworkstation VAX 
computer. 


100 dots-per-inch (100DPD) video font files—If you have a 
workstation monitor capable of displaying 100 dpi (for example, 


a VR150, VR160, or VR295), selecting 100 dpi fonts will give 


you a more readable display when you run VMS DECwindows 
applications. If your workstation monitor cannot display 

100 dpi fonts (for example, a VR260 or VR290);, you can save 
disk space by not selecting this option. For more information 
on the capabilities of your particular monitor, see the owner’s 
guide for your monitor. 


Programming support files—The VMS DECwindows 
programming support files are needed only to develop 
applications and are not required to run VMS DECwindows 
applications. Support files are supplied for the following VAX 
programming languages: Ada, BASIC, BLISS, C, FORTRAN, 
MACRO, Pascal, and PL/1. In addition, support files are 
supplied for programming in the C language using conventions 
and standards developed at the Massachusetts Institute of 
Technology. 


c. The procedure gives you the opportunity to change your mind 
before proceeding by displaying the following message: 
* Is this correct? (Y/N) 
If you answer YES to this prompt, the installation procedure 
begins restoring the VMS library save set. If you answer NO to 


this prompt, you can respecify the VMS DECwindows options that 
you want to install. 


9 The procedure displays the following messages: 


10 


Restoring VMS library save set ... 
SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring VMS optional save set ... 
*BACKUP-I-STARTVERIFY, starting verification pass 


The contents of the VMS library and optional save sets is listed in 
Appendix B. After you finish the installation, you can use VMSTAILOR 
to remove the VMS files you do not need. For more information on 
VMSTAILOR, see Chapter 3. 


If you are installing VMS DECwindows software, go to Section 2.7. 
If you are not installing VMS DECwindows software, go to Section 2.8. 
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2.7 Installing VMS DECwindows Software — 


If you are installing VMS DECwindows software, use the following 
procedure: | 


1 


Note: 


a) 


Remove the media that contains the VMS operating system from the 
source-drive when you see a message similar to the following: 

You may now remove the VMS distribution kit from MUAO:. 

Put the DECwindows distribution kit in the drive. 


Put the tape or disk that contains the VMS DECwindows software in 
the source-drive. 


If you have either an RLO2 or RKO7 kit, VMS DECwindows is on 
a magnetic tape. If you have an RX33 kit, VMS DECwindows is 
on a tape cartridge. Check the labels and put the appropriate 
piece of media in the appropriate drive. 


Enter the device name of the source-drive and press RETURN. For 
example: 


* Enter name of the drive holding the DECwindows distribution media: MUAO 
* Is the DECwindows media ready to be mounted? [N] YES 


The procedure installs the VMS DECwindows options that you 
specified and displays messages similar to the following: 
SMOUNT-I-MOUNTED, DECW53 mounted on _MUAO: 


Restoring DECwindows applications save set ... 
%$BACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows device support save set ... 
$BACKUP-I~STARTVERIFY, starting verification pass 


Restoring DECwindows 75DPI fonts save set ... 
SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows 100DPI fonts save set ... 
SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows programming support save set ... 
S$BACKUP-I-STARTVERIFY, starting verification pass 


The VMS DECwindows files are listed in Appendix C. After you finish 
the installation, you can use DECW$TAILOR to remove the VMS 
DECwindows files you do not need. For more information on removing 
files with DECW$TAILOR, see Chapter 3. 


To continue the installation procedure, go to Section 2.8. 


2.8 Joining a VAXcluster 


The installation procedure now asks you whether you are installing the 

VMS operating system in a VAXcluster environment. If you are installing 

the VMS operating system in a VAXcluster environment, the procedure 
then asks a series of questions about your configuration. 
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Creating [VMSSCOMMON] directory tree 


In a cluster, you can run multiple systems sharing all files except 


PAGEFILE.SYS, 


SWAPFILE.SYS, SYSDUMP.DMP and VAXVMSSYS.PAR. 


* Will this node be a cluster member? (Y/N) 


If you are installing the VMS operating system on a standalone 
system, type N (for NO), press RETURN. 


If you are installing the VMS operating system in a VAXcluster 
environment, type Y (for YES) and press RETURN. If you answer 
YES to the VAXcluster question, you must have a VAXcluster license. 


If you installed VMS DECwindows, the procedure displays the 
following message: 


* Do you want DECwindows as the default windowing system? (Y/N) 


Depending on your preference, type Y (for YES) or N (for NO) and 
press RETURN. If you type Y (for YES), the procedure sets the 
SYSGEN WINDOW_SYSTEM parameter to one for DECwindows. 
If you type N (for NO), the procedure sets the SYSGEN WINDOW_ 
SYSTEM parameter to zero. 


If you are installing the VMS operating system in a VAXcluster 
environment, go to step 4. 


If you are installing the VMS operating system on a standalone 
system, go to step 6. 


The procedure displays the following message: 
Now configuring system to be a cluster member. 


Determine the type of cluster configuration you want to create 
(configuration types are described in the VMS VAXcluster Manual). 
Table 2-1 lists the questions you are asked if you want a Cl-only 
configuration. Table 2—2 lists the questions you are asked if you want 
a local area VAXcluster or a mixed-interconnect configuration. Typical 
responses are explained in the tables. 


Table 2-1 Installation Questions for Cl-Only Configurations 

Question How to Respond 

Will this node be a cluster member (Y/N)? Enter Y. 

What is the node’s DECnet node name? Enter the DECnet node name—for example, 
KRUP. The DECnet node name may be from 
1 to 6 alphanumeric characters in length and 
may not include dollar signs or underscores. 

What is the node’s DECnet node address? Enter the DECnet node address—for 
example, 2.2. 

Will the Ethernet be used for cluster communications (Y/N)? Enter N. The Ethernet is not used for cluster 


(SCS internode) communications in Cl-only 
configurations. 





(continued on next page) 
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Table 2-1 (Cont.) Installation Questions for Cl-Only Configurations 





Question 


Will KRUP be a disk server (Y/N)? 
Enter a value for KRUP’s ALLOCLASS parameter: 


Does this cluster contain a quorum disk (Y/N)? 


How to Respond 


Enter Y or N, depending on your 
configuration requirements. Refer to the 
VMS VAXcluster Manual for information on 
served cluster disks. 


if the system is connected to a dual-ported 
disk, enter the appropriate allocation class 
value (it must be a value between 1 and 
255). Otherwise, enter 0. 


Enter Y or N, depending on your 
configuration. If you enter Y, the procedure 
asks for the name of the quorum disk. 
Enter the device name of the quorum disk. 
Refer to the VMS VAXcluster Manual for 
information on quorum disks. 





Table 2-2 Installation Questions for Local Area and Mixed-interconnect Configurations 


Question 


Will this node be a cluster member (Y/N)? 
What is the node’s DECnet node name? 


What is the node’s DECnet node address? 
Will the Ethernet be used for cluster communications (Y/N)? 
Enter this cluster’s group number: 


Enter this cluster’s password: 


Re-enter this cluster’s password for verification: 
Will KRUP be a disk server (Y/N)? 


How to Respond 


Enter Y. 


Enter the DECnet node name—for example, 
KRUP. The DECnet node name may be from 
1 to 6 alphanumeric characters in length and 
may not include dollar signs or underscores. 


Enter the DECnet node address—for 
example, 2.2. 


Enter Y. The Ethernet is required for cluster 
(SCS internode) communications in local 
area and mixed-interconnect configurations. 


Enter a number in the range from 1 to 4095 
or 61440 to 65535. 


Enter the cluster password. The password 
must be from 1 to 31 alphanumeric 
characters in length and may include dollar 
signs and underscores. _ 


Re-enter the password. 


Enter Y. In local area and mixed-interconnect 
configurations, the system disk is always _ 
served to the cluster. Refer to the VMS 
VAXcluster Manual for information on served 
cluster disks. 





(continued on next page) 
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Table 2—2 (Cont.) Installation Questions for Local Area and Mixed-interconnect Configurations 


Question 


Will KRUP serve HSC disks (Y)? 


Enter a value for KRUP’s ALLOCLASS parameter: 


Does this cluster contain a quorum disk (Y/N)? 


How to Respond 


Enter a response appropriate for your 
configuration. 


Enter the appropriate allocation class 
value. If you have a mixed-interconnect 
configuration, the value must be between 1 
and 255; you cannot enter 0. 


Enter Y or N, depending on your 
configuration. If you enter Y, the procedure 
asks for the name of the quorum disk. 
Enter the device name of the quorum disk. 
Refer to the VMS VAXcluster Manual for 
information on quorum disks. 





6 If you installed VMS DECwindows options, the procedure displays a 
message similar to the following: 


You may now remove the DECwindows distribution kit from $MUAO: 


Remove the distribution media from the drive and go to Section 2.9. 


7 Continue with Section 2.9. 


Setting Passwords and Running AUTOGEN 


Follow the directions in this section to set passwords and run AUTOGEN. 
AUTOGEN evaluates your hardware configuration and estimates typical 
workloads. It then sets system parameters, the sizes of the page, swap, 
and dump files, and the contents of VUSIMAGES.DAT. When AUTOGEN 
finishes and you reboot, the installation procedure is complete. 


1 The procedure asks you for new passwords for the SYSTEM, SYSTEST, 
and FIELD accounts. Passwords must be at least eight characters in 
length; they do not appear on the display. Press RETURN after you 
enter each one. After you enter the passwords, the procedure checks 
each one to make sure it meets the requirements for a good password. 


For example: 


Now we will ask you for new passwords for the following accounts: 


FIELD 


Passwords must be a minimum of 8 characters in length. All passwords 
will be checked and verified. Any passwords that can be guessed easily 


will not be accepted. 


* Enter password for SYSTEM: 
* Re-enter for verification: 


%SUAF-I~MDFYMSG, user record(s) updated 
%$VMS-I-PWD_OKAY, account password for SYSTEM verified 


* Enter password for SYSTEST: 
* Re-enter for verification: 


SUAF-I-MDFYMSG, user record(s) updated 
%VMS-I-PWD_OKAY, account password for SYSTEST verified 


The SYSTEST_CLIG account will be disabled. You must re-enable 
it before running UETP but do not assign a password. | 
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* Enter password for FIELD: 

* Re-enter for verification: 

%UAF~I-MDFYMSG, user record(s) updated 
%VMS-I-PWD_OKAY, account password for FIELD verified 


If you do not get password errors, go to step 2. 


If you enter a password incorrectly or if the password is too easy to 
guess, the procedure displays error messages similar to the following: 


%VMS-I-PWD_INVALID, account password for SYSTEST is invalid 
%VMS-I-PWD WEAK, password is too easy to guess 


Because of the preceding error, you must take action to secure this account. 
You must either disable this account, change its password, or do both. 


When the procedure asks if you want to disable the account, type N 
(for NO) and press RETURN. When the procedure asks if you want 
to enter a new password, type Y (for YES) and press RETURN. Then 
enter a new password. For example: 


Do you want to disable this account (Y/N)? N 

Do you want to change the account password (Y/N)? Y 

You must now select a new primary password for the SYSTEST account. The 
password you select must be at least 8 characters in length and may not 
be the same as the name of the account: 


New password: 

Verification: 

%SUAF-I-MDFYMSG, user record(s) updated 

%VMS-I-PWD_SET, primary password for account SYSTEST set 


After you have entered the passwords, the procedure creates your 
RIGHTS database and displays the following message: 


Creating RIGHTS database file, SYSSSYSTEM:RIGHTSLIST.DAT 
Ignore any "-SYSTEM-F-DUPIDENT, duplicate identifier" errors 


After the procedure creates the RIGHTS database, it displays the 
following messages: 


After the installation finishes, you may want to do one or more of the 
following tasks: 


Oo DECOMPRESS THE SYSTEM LIBRARIES - For space considerations, many of 
the system libraries are shipped in a data compressed format. If you 
have enough disk space, you may decompress them for faster access. To 
data expand the libraries, type: 


$ @SYSSUPDATE:LIBDECOMP .COM 


If you choose not to decompress these libraries there will be a 
negative impact on the performance of the HELP and LINK commands. 


© BUILD A STANDALONE BACKUP KIT - You can build a standalone backup kit 
using the procedure described in your VMS installation and operations 
guide which is supplied with your VAX computer. 


o TAILOR THE SYSTEM DISK - You may want to review the files provided or 
not provided during this installation. IF you find there are files 

you want to remove from the system disk (TAILOR OFF) or files you want 
to add (TAILOR ON), then use the following utilities to perform the 
desired tailoring. 


VMS tailoring: $ RUN SYSSUPDATE : VMSTAILOR 
DECwindows tailoring: $ RUN SYSSUPDATE :DECWSTAILOR 


ee ee ce EE Sa SOE SS ce eS SE ED SA cS SE AE A eT SS SAS SS MS ir SN SS MG ay: HNN SOE SD iS SS eV OY STS SD SS ee cents NAS SS SOE SE eee ae nha wee AD ae 
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Continuing with VAX/VMS V5.3 installation procedure. 


Configuring all devices on the system. 


RREKKKKKKKKEEKKKKKEEKEREKEKKEKKEKREKKKRREKERKREKKKKKKKRKKKKKKEKSE 
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After the system has rebooted you must register any Product 
Authorization Keys (PAKs) that you have received with this kit. 
You may register these PAKs by executing the following procedure: 


$ @SYSSUPDATE : VMSLICENSE 


‘See the VMS License Management Utility Manual for any additional 
information you may need. 


KRKKKKKHEEKEKKKEKEKKEKKEKEKKKEKKKRREKKKKKKKKKKKKKKKKKKEKKKKK KK KKK 


4 AUTOGEN runs and displays the following series of messages: 


Running AUTOGEN to compute new SYSGEN parameters. 


An attempt may be made to resize the pagefile or swapfile. If 
there is insufficient room on the disk, the recommended size is 
displayed with a message that the file should be created or 
extended manually by the system manager later on. 


Running AUTOGEN - Please wait. 


5 After AUTOGEN finishes, the procedure displays a series of shutdown 
messages that begins like this: 


The system is shutting down to allow the system to boot with the 
generated site-specific parameters and installed images. 


The system will automatically reboot after the shutdown and the upgrade 
will be complete. 


SHUTDOWN -~ Perform an Orderly System Shutdown 


6 After the system shuts down, the procedure tries to reboot the new 
system disk. If the system does not reboot automatically, reboot it 
manually. For information on booting, refer to the VMS installation 
and operations guide for your VAX computer. Then return to this guide 
for the next step in the VMS Version 5.3 installation procedure. 


For example, suppose you have a VAX-—11/780 and the system disk is 
on an RA60 disk drive with a unit number of one. Enter the following 
command and press RETURN: 


>>> B DUI 


7 After the system reboots, the procedure displays the following message: 


VAX/VMS Version V5.3 Major version id = 01 Minor version id = 00 
eee Se See eT eT TTT TTT TTT TCE TTT TLE TTT LT 
VAX/VMS V5.3 
You have SUCCESSFULLY installed the VMS operating system. 


The system is now executing the STARTUP procedure. Please 
await the completion of STARTUP before logging into the 
system (approximately three minutes). 


kkkKkKKKKKKKKKKKKKKKKKRKKKRKRKKKRKKKKKKKKKRK KK KKKKKKKKKKKKREKKKKKKKRKKKE 


The VAX/VMS system is now executing the system startup procedure. 


EEEEEEEEEEE OPCOM 19—APR-1990 15:200.00.00 %%%%%%%%S%E% 
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Note: The procedure displays warning messages that the VMS license 


must be registered. Be sure to register this license when the 
installation procedure finishes, as described in the VMS License 
Management Utility Manual. 


Finally, the procedure displays informational messages as well as 
accounting information. For example: 


The VAX/VMS system is now executing the system startup commands. 


%SET-I-INTSET, login interactive limit = 64, current interactive value = 0 
19-APR-1990 15:00:00.00 


SYSTEM job terminated at 19-APR-1990 15:00:00.00 
Accounting information: 
Buffered I/O count: 859 Peak working set size: 565 
Direct I/O count: 478 Peak virtual size: 2570 
Page faults: 5003 Mounted volumes: 0 
Charged CPU times 0 00:00:55.33 Elapsed time: 0 00:01:31.24 


At this point the VMS operating system is running. 


Press RETURN. The system asks you for the user name and password. 
Log into the SYSTEM account so that you can perform certain post- 
installation tasks. For example: 


Welcome to VAX/VMS V5.3 


Username: SYSTEM 
Password: 


Welcome to VAX/VMS Version V5.3 


If you forget the password, follow the instructions for performing an 
emergency startup in the Guide to Setting Up a VMS System. 


There are several things you must do before you can use the system. 
For complete information, see Chapter 3. 





3 After Installing VMS 


After you have installed the VMS operating system, you need to perform 
several important tasks to prepare the system for operation. This chapter 
tells you what the tasks are, whether they are optional or required, and 
the order in which you perform them. The following list summarizes the 
tasks that are described in this chapter: 


1 Registering your licenses—You must register the VMS license that 
came with the software. You must also register the licenses you have 
for any system integrated products that you purchased. 


2 Customizing and starting VMS DECwindows—After you register 
the VMS license you can customize and start the VMS DECwindows 
environment. 


3 Customizing the system—Depending on whether you have a 
standalone system or a system that is part of a VAXcluster 
environment, there are several things you must do. 


4 Testing the system—Once you have customized the system, run the 
VMS User Environment Test Package (UETP) to test the system. 


5 Decompressing the system libraries—After you test the system, you 
can decompress the system libraries. 


6 Removing unwanted files from the system disk —You can free up space 
on the system disk by removing the VMS and DECwindows files that 
you do not need. 


7 Backing up the system disk—To protect all the work you have just 
done, make a backup copy of the system disk. 


8 Running AUTOGEN—AUTOGEN fine tunes the system parameters 
for you. 





3.1 Registering Your Licenses 


The VMS license lets you use the VMS operating system. You must 
register this license. 


After you register the VMS license, you must register the licenses for any 
of the following system integrated products you have purchased: 


e VAXclusters 
e DECnet—VAX 
¢ RMS Journaling 


e¢ Volume Shadowing 


For step-by-step instructions on registering licenses, see the VMS License 
Management Utility Manual. 
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3.2 Starting VMS DECwindows Software 


If you have installed VMS DECwindows software, there are several. 
steps that you must take to start and customize the VMS DECwindows 
environment. Chapter 10 describes these steps. After you finish starting 
and customizing VMS DECwindows software, return to this chapter. 


For more information on starting and eee DECnet—VAX, see the 
Guide to DECnet—-VAX Networking. 


3.3 Customizing the System 


You must customize the system disk so that it automatically performs 
certain tasks when you boot. In addition, if your VAX computer is part 
of a VAXcluster environment, you must prepare the cluster operating 
environment and build the cluster. 


For instructions on customizing the system, read the following 
documentation (in the order given): 


1 Read the chapter on booting in the installation and operations guide 
for your VAX computer. This chapter explains the different ways to 
boot the system. It also tells you how to shut down the system. 


2 Ifthe computer is part of a VAXcluster environment, read the VMS 
VAXcluster Manual for further information on setting up a cluster. 


3 Ifyou have a standalone system, read the Guide to Setting Up a VMS 
System for instructions on customizing and using your system. You 
will find information on the following tasks: 


a. Editing the template files SYCONFIG.COM, SYLOGICALS.COM, 
SYLOGIN.COM, and SYSTARTUP_V5.COM 


b. Setting up user accounts 


c. Adjusting system parameters 


3.4 Testing the System 


Run the User Environment Test Package (UETP) to verify the installation. 
For complete information, see Chapter 9. Note that UETP needs at least 
1200 free blocks on the system disk. 


3.5 Decompressing the System Libraries 


Decompressing the system libraries gives the system faster access to 

the libraries. The decompressed libraries require approximately 8000 
additional blocks of disk space. To find out how much disk space you have, 
enter the following command and press RETURN: | 


$ SHOW DEVICE SYSSSYSDEVICE 
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If you have at least 8000 free blocks on the disk, you can decompress the 
libraries. The decompression process takes approximately a half hour. 
Log into the SYSTEM account, enter the following command, and press 
RETURN: 


$ @SYSSUPDATE : LIBDECOMP .COM 


3.6 Removing Unwanted Files 


Read this section if you want to remove some of the VMS operating system 
and DECwindows files that you do not need from the system disk. 


3.6.1 Using VMSTAILOR 


To remove unwanted VMS files from the system disk, use VMSTAILOR. 
For example, if you are not running DECnet—VAX, you do not need the 

network support files. To remove unwanted files with the VMSTAILOR 
program, do the following: 


1 
2 


Note: 


Log in to the SYSTEM account. 

Enter the following command, and press RETURN: 
$ RUN SYSSUPDATE: VMSTAILOR 

VMSTAILOR displays the following message: 


Do you want to tailor files "ON" or "OFF"? 
Type OFF to remove unwanted files. 


The VMSTAILOR program lists each group of files and its size in 
blocks. Files are grouped according to their function. For example, all 
the files required for network support are in one group. A file group 
is made up of many small subgroups. You can eliminate an entire 
group of files, or you can eliminate one or more of its subgroups. For 
example: 
CLASS - Network support 

Size of entire class (with subclasses): 1478 


Size of common files required for any subclass: 1233 
Do you wish to select the entire class (default = NO)? 


Decide which file groups or subgroups you do not need to support your 
system. The VMSTAILOR program displays step-by-step instructions. 


VMSTAILOR displays the names of the files it deletes. After it 
finishes, AUTOGEN runs automatically to make the adjustments 
that are necessary after system files are deleted. AUTOGEN also 
reboots the system. 


You can use VMSTAILOR at any time to delete or add groups 
of VMS files to the system disk. After adding files to the system 
disk, you should apply any updates that affect them. 
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For example, suppose you do not need the VMS Version 5.3 
PHONE utility and you run VMSTAILOR to remove those 
files. Later on, if you decide you want to use PHONE, you 
can run VMSTAILOR to return the PHONE files to the system 
disk. You then apply any VMS update that has occurred since 
Version 5.3 that affected the PHONE utility. VMS update 
procedures create a .TXT file that contains a description 

of patched files. This file usually has the following format: 
SYSSUPDATE:VMSUn053.TXT. 


3.6.2 Using DECWS$TAILOR 


To remove unwanted DECwindows files from the system disk, use 
DECWS$TAILOR. For example, if you are not planning on utilizing the 
DECwindows programming support, you can remove those files. To remove 
DECwindows files from the system disk, do the following: 


1 
2 


Log in to the SYSTEM account. 
Enter the following command, and press RETURN: 


$ RUN SYSSUPDATE : DECWSTAILOR 
DECW$TAILOR displays the following message: 


Do you want to tailor files "ON" or "OFF"? 
Type OFF to remove unwanted files. 


The DECW$TAILOR program lists each group of files and its size in 
blocks. Files are grouped according to their function. For example, 
all the files required for VMS DECwindows user support are in one 
group. A file group is made up of many small subgroups. You can 
eliminate an entire group of files, or you can eliminate one or more of 
its subgroups. For example: 
CLASS - DECwindows user support files 

Size of entire class (with subclasses): 8456 


No subclasses in this tailor class. 
Do you wish to select the entire class (default = NO)? 


Decide which file groups or subgroups you do not need to support 
your system. The DECW$TAILOR program displays step-by-step 
instructions. 


When tailoring VMS DECwindows files, consider the following: 


e Applications filese—VMS DECwindows provides a variety of 
applications; including the following: Bookreader, Calculator, 
Calendar, Cardfiler, Clock, DDIF Document Viewer, EVE Text 
Editor, FileView, Mail, Notepad Text Editor, Paint Graphics Editor, 
DECterm, the Session Manager, and the Icon Box. If you are 
installing VMS DECwindows on a VAXstation, you need these 
files. You may also want these files on a nonworkstation VAX 
computer, because you can run VMS DECwindows applications 
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on a nonworkstation VAX computer and display them on a 
workstation. 


e Device support files—If you are installing VMS DECwindows on 
a VAXstation or in a cluster that includes VAXstations, you need 
these files. Otherwise you do not need them. 


Note: If you tailor device support files ON or OFF, the system 
reboots. 


¢ 100 dots-per-inch (100DPI) video font files—If you have a 
workstation monitor capable of displaying 100 dpi (for example, 
a VR150, VR160, or VR295), selecting 100 dpi fonts will give 
you a more readable display when you run VMS DECwindows 
applications. If your workstation monitor cannot display 100 dpi 
fonts (for example, a VR260 or VR290), you can save disk space by 
not selecting this option. For more information on the capabilities 
of your particular monitor, see the owner’s guide for your monitor. 


e Programming support files—The VMS DECwindows programming 
support files are needed only to develop applications and are 
not required to run VMS DECwindows applications. Support 
files are supplied for the following VAX programming languages: 
Ada, BASIC, BLISS, C, FORTRAN, MACRO, Pascal, and PL/1. 
In addition, support files are supplied for programming in the 
C language using conventions and standards developed at the 
Massachusetts Institute of Technology. 


5 DECW$TAILOR displays the names of the files it deletes. If you 
deleted device support files, AUTOGEN runs automatically and reboots 
the system. 


3.7 Backing Up the System Disk 


Now that you have spent time installing and customizing the operating 
system, protect your work by making a backup copy of the system disk. 
Digital recommends that you perform the following operations: 


¢ Make a standalone backup kit 
e Back up the system disk 


For complete information on these operations, see the installation and 
operations guide for your VAX computer. Once you have backed up the 
system disk, install any software products that you have purchased. 
Follow the directions given in the software product manuals. 


3.8 Running AUTOGEN 


Run AUTOGEN FEEDBACK and reboot the system after 24 hours of 
operation, and again two workdays later. AUTOGEN sets the values of 
system parameters and the sizes of the page and swap files according 
to the system’s workload. Digital recommends that you run AUTOGEN 
from SAVPARAMS through TESTFILES on a weekly basis and examine 
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AGEN$FEEDBACK.REPORT to determine the need for additional 
changes. 


Hardcoded values in MODPARAMS.DAT affect AUTOGEN’s calculations 
of the feedback parameters. For AUTOGEN FEEDBACK to properly 
calculate values, you should replace the hardcoded values in 
MODPARAMS.DAT with MIN_ values. 


For information on using AUTOGEN, see the Guide to Setting Up a VMS 
System. 





Part Il 


Part Il describes how to upgrade to Version 5.3 of the VMS operating system. 





4 Overview of the Upgrade Procedure 


Use the upgrade procedure when you want to obtain a higher version of 
the VMS operating system. The upgrade procedure does not initialize 
the system disk (as does the installation procedure). This means you can 
obtain the latest version of the operating system while keeping your user 
files and optional software intact. 


The Version 5.3 upgrade procedure gives you the opportunity to install 
VMS DECwindows software on the system disk. 


Note: The Version 5.3 upgrade procedure provides new files and 
directories under [VMS$COMMON...]. If you had any special 
protections and ACLs before the upgrade, you need to re-apply 
them to re-establish the security environment you previously had. 


The Version 5.3 upgrade procedure leaves your VMS license intact. You. 
do not need to re-install the VMS license after you | upgrade. (See the 
“VMS License Management Utility Manual for detailed information on 
license management for VMS Version 5.3. For example, starting with 
VMS Version 5.2 you must register your VAXcluster license before you can 


use your VAXcluster software.) 


Before you can upgrade to VMS Version 5.2, your system must be running 
at least Version 5.0 of the VMS operating system. For example, you can 
upgrade to Version 5.3 of the VMS operating system from any of the 
following versions (or related hardware releases): 


VMS Version 5.0 
VMS Version 5.0-1 
CVMS ‘Version 5.0-2 
VMS Version 5.0-2A 
VMS Version 5.1 
VMS Version 5.1-B 
VMS Version 5.1-1 
VMS Version 5.2 
VMS Version 5.2-1 





If your system is running an earlier VMS version, such as Version 4.7, 
you must upgrade to Version 5.0 of the VMS operating system first. For 
a Version 5.3 rolling upgrade, all systems in the VAXcluster environment 
must be running at least Version 5.2 of the VMS operating system. 


To perform a successful upgrade, you must understand the basic 
operations of the VAX computer that you are upgrading. Refer to the 
VMS installation and operations guide for your VAX computer. If you have 
a VAXcluster environment, refer to the VMS VAXcluster Manual. 


This chapter describes what happens during the upgrade procedure. It 
also tells you what you need and lists some restrictions. 
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4.1 What Happens During an Upgrade 


When you upgrade the VMS operating system, the upgrade procedure does 
the following: 


1 


Note: 


Makes room for the upgrade by purging and deleting select VMS and 
VMS DECwindows files, but leaves all the user files intact 


Transfers the VMS and VMS DECwindows files from the distribution 
media to the system disk 


The upgrade puts the most recent versions of the VMS files in 
SYSSCOMMON. 


Merges the old and the new VMS and VMS DECwindows files 
Cleans up files and structures used only during the upgrade 


4.2 Cautions and Restrictions 


You must be aware of the following cautions and restrictions before you 
begin the upgrade: 
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The upgrade procedure does not work across the network. 


If you have changed the names of system directories on your system 
disk, the upgrade procedure will not work correctly. Restore your 
system disk to a standard directory structure before you attempt an 
upgrade. 


If you elect not to install VMS DECwindows software, the upgrade 
procedure removes existing VMS DECwindows files from the system 
disk. You can install VMS DECwindows software during the initial 
installation, or later using DECW$TAILOR. 


Do not attempt to use VMSINSTAL with OPTIONS G to transfer 
VMS and VMS DECwindows save sets to another media type. If 
you upgrade using a kit made in this manner, you will produce an 
unusable system. 


The VMS save sets must be in the [000000] directory on the system 
disk. The save sets are in this directory on all Digital-supplied 
distribution kits. If you have to move the VMS save sets, they must be 
in the [000000] directory, or the upgrade will fail. 


If you have a shared system dump file in SYS$COMMON:[SYSEXE], 
the dump file cannot have the name SYSDUMP.DMP. If you have a 


shared system dump file with this name, Digital recommends that you 


rename it to SYS$COMMON:[SYSEXE]JSYSDUMP-COMMON.DMP. 
For more information, see the VMS Version 5.2 Release Notes. 


You must not move the system disk or the VMS distribution kit from 
one drive to another during the upgrade. 


The upgrade procedure deletes all the operator and accounting logs. 
To save these files, move them to a user directory before you start the 
upgrade. 
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Before you start the upgrade procedure in a VAXcluster environment, 
you must shut down all the nodes that boot from the system disk you 


are upgrading. 


Record the upgrade procedure on either a hardcopy terminal or a 
printer attached to the console terminal. If you do not do this, the 
screen messages will be lost. You will need a transcript in case there 
is a problem. 


The upgrade procedure is designed so that you should not have to re- 
install most layered products after the upgrade. However, you might 
need to re-install certain layered products because of product-specific 
installation procedures. 


For example, you must re-install layered products that either create 
directories synonymous with system directories or use VMS-defined 
data structures. If a layered product is available (refer to Appendix D), 
yet exhibits unexpected behavior once Version 5.3 of the VMS 
operating system is running, check the VMS Version 5.3 Release 
Notes for layered product restrictions. If problems persist, contact your 
Digital representative. 


4.3 What You Need for the Upgrade 


You need the following items to perform the upgrade to Version 5.3 of the 
VMS operating system: 


Pe 


ye 


VMS Version 5.3 software distribution kit 


Scratch console media (media that does not contain files you want to 
save) for the following VAX computers: 


VAX 8600, 8650 

VAX 8200, 8250, 8300, 8350 
VAX-11/730 

VAX—11/750 


For example, if you have a VAX—11/780 or VAX—11/785, you need a 
blank RX01 floppy diskette. 


To prepare for an upgrade, follow the instructions in Chapter 5. 


is 
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NOTE: 


3.1 


9.2 


Before you do an upgrade, you need to perform several important tasks 
to prepare the system. The following list summarizes these tasks, each of 
which is described in this chapter: 


1 Understanding VMS Version 5.3—You need to read the VMS Version 
5.3 New Features Manual and VMS Version 5.3 Release Notes before 
you upgrade the system. 


2 Saving AUTOGEN FEEDBACK parameters. 


3 Backing up the system—For your protection, you must make a backup 
copy of the system disk and, in some cases, the console media. 


4 Preparing the system disk—You need to move any files that might 
affect the upgrade to a user directory and make sure that you have 
enough space on the system disk for the upgrade. You also need to 
check and set certain SYSGEN parameters. 


5 Preparing the system—You must stop all queues and, if applicable, 
shut down the network. You also need to set the system up for 
automatic restart. For some VAX computers this means modifying 
boot command procedures. 


If you are using volume-shadowed system disks, you must perform 
additional tasks before doing an upgrade. For more information, 
refer to the VAX Volume Shadowing Manual. 


During the upgrade procedure, you are asked to boot the system from 
[SYSF]. Some VAX computers require a special command procedure to 
boot from [SYSF]. If you do not know how to boot from [SYSF], read 
Appendix A in this guide. 


Understanding Version 5.3 of the VMS Operating System 


Before you begin the upgrade, read VMS Version 5.3 New Features Manual 
and VMS Version 5.3 Release Notes. These manuals describe the changes 
made to the VMS operating system in Version 5.3. 


AUTOGEN FEEDBACK Parameters 


After the upgrade is finished, AUTOGEN runs. If it finds valid 
FEEDBACK data on your system, it tries to use AUTOGEN FEEDBACK. 
FEEDBACK data is produced by the SAVPARAMS phase of AUTOGEN 
and is stored in SYS$SYSTEM:AGEN$FEEDBACK.DAT. Valid 
FEEDBACK data is defined as follows: 


¢ The system was up for at least 24 hours when the FEEDBACK data 
was gathered 
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¢ The FEEDBACK data is not over 30 days old 


Note: If your FEEDBACK data is NOT valid, AUTOGEN will run 


WITHOUT FEEDBACK (all previous FEEDBACK generated 
parameters will be replaced by the AUTOGEN NOFEEDBACK 
calculations). 


%, To insure that AUTOGEN FEEDBACK will run after the upgrade, do the 


following: 


1 Check the validity of your current FEEDBACK data by entering the 
following command: 


S$ @SYSSUPDATE:AUTOGEN GETDATA TESTFILES 


This command is for test purposes and does not result in the 
modification of SYSGEN parameters or changes to the page and 
swap files. If your current FEEDBACK is valid, AUTOGEN will use it 
during the upgrade. 


AUTOGEN will issue several warnings if your current FEEDBACK 
data is invalid. If your current FEEDBACK data is invalid, go to 
step 2. 


2 If your current FEEDBACK is invalid, you can generate new 
FEEDBACK data (assuming your system was up for at least 
24 hours). Enter the following command: 


$ @SYSSUPDATE:AUTOGEN SAVPARAMS TESTFILES 


This command is for test purposes and does not result in the 
modification of SYSGEN parameters or changes to the page and 
swap files. Again, AUTOGEN warns you if the FEEDBACK data just 
produced is invalid. 


3 Ifyou follow steps 1 or 2 and your current FEEDBACK data is valid, 
AUTOGEN uses your current FEEDBACK generated parameters 
during the upgrade. Your current FEEDBACK generated parameters 
will not be lost during the upgrade. 





5.3 Backup Procedures 
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Digital recommends that you make a backup copy of the system disk 
and, if your configuration allows it, upgrade the backup copy. If there are 
problems, you still will have a working system disk. To make a backup 
copy of the system disk, follow the instructions in the VMS installation 
and operations guide for your VAX computer. | 


If you have a VAXcluster environment with more than one system disk, 
make sure the volume label on each system disk and backup copies of 
system disks are unique. Use the SET VOLUME/LABEL command to 
change a volume label, if necessary. 


If you have one of the following VAX computers, you also must make a 
backup copy of the console media: 


° VAX-11/730 
° VAX-11/750 
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© (VAX-11/780) 785 


VAX 8200, 8250, 8300, 8350 
VAX 8600, 8650 


The upgrade procedure updates the console media for you. Use the backup 
copy of the console media during the upgrade procedure. If there are 
problems, you will still have a working copy of the console media. To make 


a backup copy of the console media, use the CON SCOPY. COM procedure. 


as described in the VMS installation and ope 
computer. 





5.4 Preparing the System Disk 
Prepare the system disk for the upgrade using the following procedure: 


1 
2 


Note: 


/ 


Log into the SYSTEM account. 


If you need to boot the backup copy of your system disk, or if you are 
upgrading a VAXcluster environment, enter the following command 
(otherwise, go to step 5): 


S @SYSSSYSTEM: SHUTDOWN 


When the procedure asks if an automatic system reboot should be 
performed, press RETURN for NO. If you are a VAXcluster member, 
choose the CLUSTER_SHUTDOWN option. When the procedure is 
finished, halt the system as described in the VMS installation and 
operations guide for your VAX computer. 


If applicable, remove the system disk and replace it with the backup 
copy. 
Boot the system from the backup copy of the system disk. If you do 


not know how to boot the system, refer to the VMS installation and 
operations guide for your VAX computer. 


Log into the SYSTEM account. 


The current copy of SYSUAF.DAT must be on the system disk in 
SYS$SYSTEM. Otherwise, you cannot proceed with the upgrade. If 
you have moved your copy of SYSUAF.DAT to another location, copy it 
to SYS$SYSTEM for the duration of the upgrade. 


If you are doing a rolling upgrade, the shared version of 
SYSUAF.DAT is not updated. 


Move any files that you do not want changed into a user directory. 


If you have a shared system dump file in SYSSCOMMON:[SYSEXE], 
the dump file cannot have the name SYSDUMP.DMP. If you have a 
shared system dump file with this name, Digital recommends that you 
rename it to SYS$COMMON:[SYSEXE]JSYSDUMP-COMMON.DMP. 
For more information, see the VMS Version 5.2 Release Notes. 


To analyze the system disk for inconsistencies and errors in the file 


/structure, enter the following command: 


$ ANALYZE/DISK_STRUCTURE SYSSSYSDEVICE 
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Ignore the following message: 
SVERIFY-I_OPENQUOTA, error opening QUOTA.SYS 
If you find any other errors on the system disk, repair the errors by 
ismietnge. © ais Z entering the following command: 


- hogy co LA PEED mee 


$ ANALYZE/DISK_STRUCTURE/REPAIR SYSSSYSDEVICE 


Check the page file to make sure it is at least 4600 blocks. Use the 
following procedure: 


a) yh e. rt je . 


8) 


a. ‘To find out the size of the page file, enter the following command: 
$ @SYSSUPDATE:SWAPFILES 


_ The procedure displays the size of the page file and asks you to 
A enter a new value, as follows: 


Enter new size for paging file: 


If the page file size (PAGEFILE.SYS) is greater than 4600 blocks, 
press RETURN. If it is less than 4600 blocks, enter 4600 and press 
RETURN. 


b. Ifthe swap and dump files are on the system disk, the procedure 
displays the sizes of each file. To keep the current values, press 
RETURN after each prompt. 


If the swap file is not on the system disk, the procedure asks if 

/ you want to create one. You do not need swap and dump files on 
the system disk for the upgrade procedure. Enter the appropriate 
response for your system. 


If you changed the size of the page file or created a swap file, a 
message is displayed that tells you to reboot the system. Do not 
reboot now. You will reboot later. 


10 Check the system disk to make sure there is enough room for the 
upgrade. To determine whether you have enough room, enter the 
/ following command: 


$ SHOW DEVICE SYSSSYSDEVICE 
The number of free blocks should be greater than 31,000. 


11 During the upgrade procedure you will shut down and reboot the 
system a number of times. To avoid configuring all the devices on the 
system during the reboot, set the SYSGEN parameter STARTUP_P1 
to MIN. Enter the following commands, pressing RETURN after each 


/ one: 


$ RUN SYSSSYSTEM: SYSGEN 
SYSGEN> USE CURRENT 

SYSGEN> SET STARTUP_P1 "MIN" 
SYSGEN> WRITE CURRENT 
SYSGEN> EXIT | 


12 Any SYSGEN parameters that you modified and did not enter in 
a MODPARAMS.DAT are lost during the upgrade. To retain these 
parameters, enter their names in MODPARAMS.DAT and the value 
that AUTOGEN needs to add to the default minimum value. 
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For example, if you modified GBLPAGES by 128 pages above the 
default, enter 128 into MODPARAMS.DAT, as follows: 


ADD _GBLPAGES=128 


When AUTOGEN runs after the upgrade it uses the values in 
MODPARAMS.DAT. 


13 To prepare the system for the upgrade, go to Section 5.5. 





5.5 Preparing the System 


To prepare the system for the upgrade, use the following procedure: 


1 


; 


o< N 


To determine whether your system is running DECnet—VAX software, 
enter the following command: 


$ SHOW NETWORK 
If the system displays the following message, go to step 2: 
%SHOW-I-NONET, network unavailable 


If the system displays information on the status of the VAX/VMS 
network, enter the following commands to shut down the network: 


$ RUN SYSS$SYSTEM:NCP 
NCP> SET EXECUTOR STATE OFF 
NCP> EXIT 


_ To stop all batch and print queues, enter the following command: 


$ STOP /QUEUE/MANAGER 


If your computer uses console media, you can avoid rebooting the 
system manually during the upgrade, by setting the computer to 
restart automatically. For some VAX computers this means setting 
one or more switches. For others, this means entering certain console 
mode commands. To determine how to enable auto restart, refer to the 
VMS installation and operations guide for your VAX computer. 


If you have a system that does not use console media, set your system 
so you can reboot it manually. For more information, refer to the VMS 
installation and operations guide for your VAX computer. 


To activate any SYSGEN parameters that you changed (STARTUP_PI1, 
for example), you must shut down and reboot the system at this point. 
Enter the following command: 


S$ @SYSSSYSTEM: SHUTDOWN 


When the procedure asks if an automatic system reboot should be 
performed, type Y (for YES) and press RETURN. 


After the system reboots, log into the SYSTEM account. 


- Run SYSGEN to reconfigure the devices on the system and run 


STARTUP CONFIGURE. Enter the following commands: 


9-5 


5.6 


Before You Do an Upgrade 
5.5 Preparing the System 


/ 


Summary 


$ RUN SYSSSYSTEM: SYSGEN 
SYSGEN> AUTOCONFIGURE ALL 
SYSGEN> EXIT 


$ @SYSSSYSTEM:STARTUP CONFIGURE 


To prevent users from logging into the system during the upgrade, 
enter the following command: 


$ SET LOGINS/INTERACTIVE=0 


Perform this step only if you are upgrading one of the following VAX 
computers (otherwise go to Section 5.6): 


VAX 8530, 8550, 8810, 8820-N 
VAX 8820, 8830, 8840 


Before beginning the upgrade procedure, you must modify the boot 
command procedures, DEFBOO and dddGEN. To modify the boot 
command procedures, exit from the VMS operating system (but do not 
shut it down) and enter the appropriate console mode. Make copies 
of DEFBOO and dddGEN before you modify them. Name the copies 
DEFBOO.SAV and dddGEN.SAV. 


The VMS installation and operations guide for your VAX computer 
describes the procedures for copying and modifying DEFBOO and 
dddGEN. Use these procedures to modify DEFBOO and dddGEN so 
that they specify [SYSF] as the directory from which to boot. 


In DEFBOO, change the BOOT command, as follows: 
BOOT dddn/R5=F0000000 


In dddGEN, change the DEPOSIT command that sets boot flags in 
register 5 (Rd), as follows: 


DEPOSIT R5 FOOQOQOOOL 
Go to Section 5.6. 


Perform this step only if you are upgrading a VAX 8200, 8250, 8300, 
or 8350 computer (otherwise go to Section 5.6). Before beginning the 
upgrade, you must create a boot command procedure that allows you 
to boot from the [SYSF] directory. 


Appendix A describes the procedures for setting the system up to boot 
from the [SYSF] directory. 


Go to Section 5.6. 





All of the following conditions must be met for the upgrade procedure to 
continue. Make sure: 


SYSUAE.DAT is in SYS$SYSTEM 
PAGEFILE.SYS is in SYS$SPECIFIC:[SYSEXE] 
The system disk has 31,000 free blocks 

Volume shadowing is disabled on the system disk 


“To upgrade a 
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STARTUP_P1 is set to MIN 
DECnet—VAX is shut down 

The queue manager is not running 

The page file is at least 4600 blocks 

The system is set to automatically restart 


fi reaba PHATELATTENRAESAA ZONING 7TOCNT ERO Reais | eran 


standalone system, go to Chapter 7. 





To upgrade a VAXcluster environment, go to Chapter 6. 
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6 Upgrading a VAXcluster Environment 


This chapter describes how to upgrade a VAXcluster environment. Refer to 
the VMS VAXcluster Manual for more detailed information on VAXcluster 
environments. 


There are two types of cluster upgrades: concurrent and rolling. The 
type of upgrade you use depends on whether you want to maintain the 
availability of the cluster during the upgrade and whether you have more 
than one system disk: 


e Concurrent upgrade—During a concurrent upgrade, you must shut 
down the entire cluster and upgrade each system disk. No one can use 
the cluster until you upgrade each system disk, and reboot each VAX 
computer. If all systems in the VAXcluster environment boot from one 
system disk, you must perform a concurrent upgrade. To perform a 
concurrent upgrade, see Section 6.1. 


e Rolling upgrade—During a rolling upgrade, you can keep some of 
the VAX computers in the cluster running while you upgrade others 
(assuming that you have more than one system disk). The cluster runs 
temporarily with different versions of the VMS operating system. To 
perform a rolling upgrade, see Section 6.2. 


6.1 Performing a Concurrent Upgrade 


You perform a concurrent upgrade by shutting down the entire cluster, 
upgrading each system disk, and rebooting each VAX computer in the 
cluster. When the cluster reboots, each VAX computer will be running the 
upgraded version of the VMS operating system. Users cannot access the 
cluster until you upgrade each system disk and reboot each VAX computer. 


To perform a concurrent upgrade, use the following procedure: 


1 Shut down the entire cluster by logging into the SYSTEM account on 
each node locally, entering the following command, and choosing the 
CLUSTER_SHUTDOWN option: 


$ @SYSSSYSTEM: SHUTDOWN 
2 If you have only one system disk for your cluster, go to step 3. 
If you have more than one system disk, select one to upgrade. 


3 Perform a conversational boot of a single VAX computer from the 
system disk you will be upgrading. For more information about the 
conversational boot procedure, refer to the VMS installation and 
operations guide for your VAX computer. 
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At the SYSBOOT> prompt, use the SHOW VOTES and SHOW 
EXPECTED_VOTES command to display the current values of the 
parameters. Write these values down because you will need to restore 
them later. Set the VOTES and EXPECTED_VOTES values to 1, by 
entering the following commands. Press RETURN after each one: 


SYSBOOT> USE CURRENT 
SYSBOOT> SET VOTES 1 
SYSBOOT> SET EXPECTED VOTES 1 
SYSBOOT> CONTINUE 


4 Upgrade the system disk, using the procedure in Chapter 7. 
5 Ifyou have only one system disk, go to step 6. 


If you have more than one system disk, shut down the system that you 
just upgraded. Then repeat steps 3 and 4 to upgrade each system disk 
in the cluster. When you finish upgrading each system disk, go to 

step 6. 


6 Reboot each computer in the VAXcluster environment. 


7 Then complete the post-upgrade procedure, described in Chapter 8. 





Rolling Upgrade Overview 


CAUTION: 
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During a rolling upgrade, you upgrade each system disk individually, 
allowing old and new versions of the VMS operating system to run 
together temporarily in the same cluster. Clusters running two versions 
of the VMS operating system are called mixed-version clusters. Because 
rolling upgrades allow mixed-version clusters, you maintain availability of 
the systems that you are not upgrading. 


To perform a Version 5.3 rolling upgrade, the other nodes in the 
cluster must be running at least Version 5.2 of the VMS operating 
system. 


Digital recommends that all VAX computers in a cluster run the 
same version of the VMS operating system. Mixed-version clusters 
are supported only for the purpose of upgrading the entire cluster 
incrementally. 


A rolling upgrade does not apply when all systems boot from a single 
system disk. When all systems boot from a single system disk, perform a 
concurrent upgrade using the procedure described in Section 6.1. 


Performing a Rolling Upgrade 


To perform a rolling upgrade, use the following procedure: 


1 Check the votes and make adjustments to maintain the proper quorum 
so that the cluster can continue to operate throughout the upgrade. 
(The VMS VAXcluster Manual describes this procedure in detail.) 


2 Select a system disk to upgrade. 


3 


Note: 


CAUTION: 


7 
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If proper quorum is not maintained at any time during the upgrade 
procedure, the shutdown procedure will hang the cluster. If the cluster 
hangs during a shutdown, enter the following commands and press 
RETURN after each one: 


$ 
>>> H 


>>> D/I 14 C 
>>> C 

IPC> Q 

IPC> [CIRL/Z] 


Shut down all VAX computers booting from the system disk that you 
are upgrading, except for the computer that you will use to apply the 
upgrade. 


VAX computers that do not boot from the system disk that you 
are upgrading remain available to users. 


a. Log into the SYSTEM account on the VAX computer you are 
shutting down. 


b. Enter the following command and press RETURN: 
$ @SYSSSYSTEM: SHUTDOWN.COM 


c. On one of the remaining VAX computers in the cluster, enter the 
following command and press RETURN: 


$SET CLUSTER/EXPECTED VOTES 


d. Repeat steps a through c for each VAX computer requiring a 
shutdown. 


This procedure lets one VAX computer continue running from the 
system disk (assuming computers running from different system disks 
supply enough votes to sustain cluster quorum). 


Upgrade the system disk, using the procedure in Chapter 7. 


When you upgrade the system disk, be sure to use a local 
drive for the distribution media (rather than a drive that is 
accessible to the cluster). The upgrade procedure requires 
exclusive access to the drive that holds the distibution media. 


Reboot each VAX computer that boots from the system disk you have 
just upgraded. 


Repeat steps 2 through 6 for each system disk you are upgrading. 
Then complete the post-upgrade procedure, described in Chapter 8. 


7 Standalone Upgrade 


This chapter explains the upgrade procedure for a single VMS system. 
Before you begin the upgrade procedure, you must read the overview of 
the upgrade procedure described in Chapter 4 and complete the entire 
pre-upgrade procedure described in Chapter 5. 


CAUTION: You cannot install or upgrade to Version 5.3 of the VMS operating 
system on the following VAX computers and system disks: 


e MicroVAX I, VAXstation I, and VAX 11/725 

e RK07, RLO2, RC25, RD51, and RD52 system disks 

The upgrade procedure is divided into six phases. You must complete each 
phase of the upgrade procedure. On most VAX computers the upgrade 
procedure continues automatically from phase to phase. Read the screen 


displays carefully and, if you need to reboot your VAX computer manually, 
refer to the VMS installation and operations guide for your VAX computer. 


7.1 Beginning the Upgrade Procedure 


This section describes how to get your disk and tape drives ready and 
how to start the upgrade procedure using VMSINSTAL. You can type a 
question mark (?) for help at any time while running VMSINSTAL. 


The instructions refer to the source-drive and the target-drive where: 
Mund: e The source-drive is the drive that holds the distribution kit. 
Due2se The target-drive is the drive that holds the system disk. 


1 Put the distribution media in the source-drive. If your VMS 
i _ distribution kit contains several pieces of media, put the first volume 
in the drive. 


2 To start VMSINSTAL, use the following procedure: 
a. Log in to the SYSTEM account. 
b. Enter the following commands and press RETURN after each one: 


"4 $ SET DEFAULT SYSSUPDATE 
$ @VMSINSTAL 


VMSINSTAL displays messages similar to the following: 


VAX/VMS Software Product Installation Procedure V5.2 


It is 19-APR-1990 at 15:00.00.00 
Enter a question mark (?) at any time for help. 


3 The procedure displays the following message: 


/ * Are you satisfied with the backup of your system disk [YES]? 
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If you have made a backup of the system disk, press RETURN and go 
to step 4. | 


If you have not made a backup of the system disk, do the following: 


a. Type N (for NO) and press RETURN. VMSINSTAL ends and the 
dollar-sign prompt ($) is displayed. 


b. Back up the system disk as described in the VMS installation and 
operations guide for your VAX computer. 


c. After you have made a backup of the system disk, start the 
upgrade procedure again from the beginning of Section 7.1. 


VMSINSTAL asks for the name of the drive that holds the distribution 
media: 


* Where will the distribution volumes be mounted: 


Enter the device name of the source drive. For example, if you have a 
VAX 6000 series computer that has a TK70 with a device name of 
MUC6, enter the following command and press RETURN: 


* Where will the distribution volumes be mounted: MUC6 


If the drive is connected to an HSC, enter the HSC name and the 
device name of the drive separated by a dollar sign ($). For example, 
if the HSC name is MUTT, and the device name is DJA2, enter the 
following and press RETURN: 


* Where will the distribution volumes be mounted: MUTTSDJA2 


If VMSINSTAL displays an error message, make sure the drive is 
connected and set up properly. Enter the name again. If VMSINSTAL 
displays another error message, verify the device name using the 
following procedure: 


a. Press CTRL/Y. 


b. Enter the SHOW DEVICE command to make sure you have the 
correct device name. 


c. Start the upgrade procedure again from the beginning of 
Section 7.1. 


When VMSINSTAL displays the following message, type VMS053 and 
press RETURN. Make sure that you use the number zero when you 
type VMS053. For example: 


_* Products: VMS053 


When the procedure displays the following message, press RETURN: 
* Enter the installation options you wish to use [none]: 
VMSINSTAL displays a message similar to the following: 

Please mount the first volume of the set on _DJAZ2. 


When the procedure displays the following message, type Y (for YES) 
and press RETURN: 


* Are you ready? Y 
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After several minutes, the procedure displays messages similar to the 
following: 


S$MOUNT-I-MOUNTED, VMS053 mounted on _DJA2: 
The following products will be processed: 
VMS V5.3 
After several more minutes, the procedure displays messages similar 
to the following: 


Beginning installation of VMS 5.3 at 15:05 
SVMSINSTAL-I-RESTORE, Restoring product saveset A... 
VAX/VMS V5.3 Upgrade Procedure 


Model: VAX-8800 
System device: RA82 - KROKSDUAIL: 
Free blocks: 752667 


The upgrade procedures display several messages that provide you 
with the following information: 


¢ What VMSINSTAL is doing. 


e Notes, suggestions, and restrictions about various parts of the 
upgrade. 


e Status of the upgrade. 


Read these messages carefully to decide whether or not you need to 
interrupt the upgrade procedure. 


8 An interruption is allowed before Phase 1. The procedure displays the 
following message: 


* Do you want to continue? (Y/N): 

To continue the upgrade, type Y (for YES) and press RETURN. 
To interrupt the upgrade, do the following: 

a. Type N (for NO) and press RETURN. 

b. Press CTRL/Z. 


9 The procedure displays the current date and time. If the date and 
time are correct, type Y (for YES). If they are incorrect, type N (for 
/ NO). Enter the correct date and time using the 24-hour clock format 
and press RETURN. For example: 


PLEASE ENTER DATE AND TIME (DD-MMM-YYYY HH:MM) 19-APR-1990 15:10 


10 Continue with Phase 1 of the upgrade. 
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Upgrade Phase 1 


This section describes Phase 1 of the upgrade. During Phase 1 you provide 
passwords for system accounts and select VMS and VMS DECwindows 
options. During Phase 1 the procedure restores the VMS Version 5.3 files 
in the VMS required save set. At the end of Phase 1, the procedure shuts 
down your VAX computer. If you have a computer with console media, the 
system will probably automatically reboot. If your computer does not use 
console media, you must manually reboot from the SYSF directory. 


At the beginning of Phase 1, the procedure displays a message similar to 
the following: 


Upgrade Phase 1 19-APR-1990 15:11:17.05 


1 To ensure system security, the upgrade procedure requires you to 
change the passwords for the SYSTEM, SYSTEST, and FIELD 
accounts before continuing. Passwords must be at least eight 
characters in length; they do not appear on the display. Press 

7 RETURN after you enter each one. After you enter the passwords, 
the procedure checks each one to make sure it meets the requirements 
for a good password. For example: 

To help provide a more secure system, you are asked to enter passwords 


for key system accounts. Passwords must be a minimum of 8 characters 
in length. You may enter new or existing passwords. 


Enter passwords for the following accounts: 
SYSTEM, SYSTEST, FIELD 


* Enter password for SYSTEM: 

* Re-enter for verification: 

%SUAF-I-MDFYMSG, user record(s) updated 
%VMS~I~-PWD_OKAY, account password for SYSTEM verified 


* Enter Password for SYSTEST 

* Re-enter for verification: 

SUAF-I-MDFYMSG, user record(s) updated 
%VMS-I-PWD_OKAY, account password for SYSTEST verified 


The SYSTEST CLIG account will be disabled. You must re-enable 
it before running UETP but do not assign a password.) 


Enter new password for account FIELD: 

Re-enter the password for account FIELD for verification: 
%SUAF-I-MDFYMSG, user record(s) updated 

%VMS-I-PWD_OKAY, account password for FIELD verified 


If you do not get password errors, go to step 2. 


If you enter a password incorrectly or if the password is too easy to 
guess, the procedure displays error messages similar to the following: 


%VMS-W-PWD_ INVALID, account password for FIELD is invalid 
-VMS-I-PWD_WEAK, password is too easy to guess 


Because of the preceding error, you must take action to secure this account. | 
You must either disable this account, change its password, or do both. 

When the procedure asks if you want to disable the account, type N 
(for NO) and press RETURN. When the procedure asks if you want 
to enter a new password, type Y (for YES) and press RETURN. Then 
enter a new password. For example: | 
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Do you want to disable the account (Y/N)? N 

Do you want to change the account password (Y/N)? Y 

You must now select a new primary password for the FIELD account. The 

password you select must be at least 8 characters in length and may not be the 
same as the name of the account. 


New password: 

Verification: 

SUAF-I-MDFMSG, user record(s) updated 

%VMS-I-PWD-SET, primary password for account FIELD set 


The procedure does the following: 

e Turns off quotas on the system disk 
e Stops OPCOM 

e Stops the error formatter (ERRFMT) 


If your VAX computer does not have console media, go to step 5. If 
your VAX computer has console media, the procedure might ask you 
to insert the console media in the drive. Use the backup copy of the 
console media. Make sure the console media is write-enabled. Insert 
the console media in the drive and do not remove it from the drive 
until the upgrade has been completed. The procedure displays a 
message similar to the following: 


* Do you want to boot from the [console media]? 


If you are booting directly from a local system disk, type N (for NO) 
and press RETURN. If you are using a CI750, type Y (for YES) and 
press RETURN. 


If you typed Y (for YES), the procedure displays a series of messages 
about booting from console media. Follow the instructions displayed 
on the screen. 


The procedure displays the following message: 


* Do you want to continue? (Y/N) 
To interrupt the upgrade, type N (for NO) and press RETURN. 


To continue the upgrade, type Y (for YES) and press RETURN. For 
some computers, the procedure temporarily modifies DEFBOO.CMD 
(or DEFBOO.COM if you have a VAX 8600 computer) to boot from 

the [SYSF] directory. During Phase 4 of the upgrade, the procedure 
restores the DEFBOO.CMD (or DEFBOO.COM if you have a VAX 8600 
computer) file that is set up to boot from the current system disk and 
system root. 


The procedure does the following: 


e Cleans up the system disk by purging all accounting data files, 
operator logs, and the directory SYSERR. The procedure also 
deletes all JNL files in the root directory and its subdirectories. 


e Builds the directory tree [SYSF] and deletes the VMS and VMS 
DECwindows files that are not needed to reboot during Phase 1 of 
the upgrade. 
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6 The procedure displays a series of messages about VMS and VMS 
DECwindows files. To select the VMS and VMS DECwindows options 
you want to install, follow the instructions displayed on the screen. 
For example: 


The full VMS kit will be installed on this system disk. 
The following components (with approximate sizes) will be provided: 


VMS library - 27500 blocks 
VMS optional - 9000 blocks 


You can provide DECwindows support now, or you can use the 
DECWSTAILOR utility to provide or remove DECwindows support 
after the installation. 


NOTE: Some media, TK50s in particular, can be very slow when 
tailoring on files. You might want to provide DECwindows 
options now and tailor off unwanted files later. 


*Do you want to provide optional DECwindows support? (Y/N) 


CAUTION: If you elect not to install VMS DECwindows software, the 
_ upgrade procedure removes existing VMS DECwindows files 

/ from the system disk. If you do not install VMS DECwindows 
at this time, you can install it after the upgrade using 
DECWS$TAILOR. Please note that for TK50 tape cartridges, 
it is quicker to install VMS DECwindows software during the 
upgrade than to tailor VMS DECwindows on after the upgrade. 
For more information about using DECW$TAILOR to install 
VMS DECwindows software, see Appendix F. 


If you do not want to install VMS DECwindows software, type N (for 
NO) and go to step 7. Note that VMS DECwindows software is useful 
even on a nonworkstation VAX computer, because you can run VMS 
DECwindows applications on a nonworkstation VAX computer and 
display them on a workstation. 


If you do want to install VMS DECwindows software, do the 
following: 


a. Type Y (for YES) and press RETURN. The procedure displays the 
following message: 


You can install either the complete DECwindows kit or selected portions 
of it. A complete installation requires 44500 blocks. If you 

want to perform a partial installation, you can choose to install one 
or more of the following DECwindows components: 


-DECwindows device support = 9500 blocks 
-DECwindows applications - 11000 blocks 
-DECwindows programming support - 24000 blocks 


* Do you want to install complete DECwindows support? (Y/N) 


b. To install the complete DECwindows kit, type Y (for YES) and 
press RETURN. The procedure displays the amount of remaining 
disk space, the DECwindows options that will be provided. 


To install selected portions of the VMS DECwindows kit, type N | 
(for NO) and press RETURN. The procedure displays information 
about the amount of space you need on the system disk for each 
option. As you choose your options, the procedure calculates the 
amount of space that would be left on the system disk. 
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Consider the following before you select the VMS DECwindows 
options that you want to install: 


¢ Device support files—If you are installing VMS DECwindows 
on a VAXstation or in a cluster that includes VAXstations, you 
need these files. Otherwise you do not need them. Please note 
that if you select the device support files, you automatically get 
the applications files. 


¢ Applications files—VMS DECwindows provides a variety of 
applications including the following: Bookreader, Calculator, 
Calendar, Cardfiler, Clock, DDIF Document Viewer, EVE Text 
Editor, FileView, Mail, Notepad Text Editor, Paint Graphics 
Editor, DECterm, the Session Manager, and the Icon Box. If 
you are installing VMS DECwindows on a VAXstation, you 
need these files. They are also useful on a nonworkstation VAX 
computer. 


¢ 100 dots-per-inch (100DPI) video font files—If you have a 
workstation monitor capable of displaying 100 dpi (for example, 
a VR150, VR160, or VR295), selecting 100 dpi fonts will give 
you a more readable display when you run VMS DECwindows 
applications. If your workstation monitor cannot display 
100 dpi fonts (for example, a VR260 or VR290), you can save 
disk space by not selecting this option. For more information 
on the capabilities of your particular monitor, see the owner’s 
guide for your monitor. 


¢ Programming support files—The VMS DECwindows 
programming support files are needed only to develop 
applications and are not required to run VMS DECwindows 
applications. Support files are supplied for the following VAX 
programming languages: Ada, BASIC, BLISS, C, FORTRAN, 
MACRO, Pascal, and PL/1. In addition, support files are 
supplied for programming in the C language using conventions 
and standards developed at the Massachusetts Institute of 
Technology. 


c. The procedure gives you the opportunity to change your mind 
before proceeding by displaying the following message: 


* Is this correct? (Y/N) 


If you answer YES to this prompt, the installation procedure 
begins restoring the VMS required save set. If you answer NO to 
this prompt, you can respecify the VMS DECwindows options that 
you want to install. 


The VMS DECwindows files are listed in Appendix C. Use 
DECWS$TAILOR to remove the VMS DECwindows files you do 
not need. For more information on DECW$TAILOR, see the VMS 
installation and operations guide for your VAX computer. 


The procedure will restore the VMS DECwindows options you choose 
during Phase 2. 


an 


7 / The procedure restores the VMS required save set and purges the 
page, swap, dump, and authorization files. 
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After several minutes, the upgrade procedure indicates that it will 
shut down to reboot the partially upgraded VMS Version 5.3 system. 


If your system uses console media, it should automatically reboot 
from the SYSF directory when the shutdown is complete. If you 
have a MicroVAX or if your system does not reboot from SYSF, halt 
the system and boot from the [SYSF] directory. For most MicroVAX 
and VAXstation computers, use the BOOT command in the following 
format and substitute the device name of the system disk for ddcu: 


>>> B ddcu 


For more information on booting your computer from the SYSF 
directory, see Appendix A. 


When the system reboots, it displays the VMS banner similar to the 
following: 


VAX/VMS Version BC53-xxx Major version id = 1 Minor version id = 0 


This section describes Phase 2 of the upgrade. During Phase 2, the 
procedure installs the VMS library and optional save sets (if you elected to 
install them), and VMS DECwindows software (if you elected to install it). 
At the beginning of Phase 2, the procedure displays a message similar to 
the following: 


Continuing with VAX/VMS V5.3 Upgrade Procedure. 


Upgrade Phase 2 19-APR-1990 15:55:42.57 


The procedure also displays messages about licenses which you can ignore. 


During Phase 2, the upgrade procedure does the following: 


1 


3 


Note: 


Phase 2 restores the rest of the optional VMS files. If your VMS 
distribution kit contains more than one piece of media, the procedure 
asks you to replace the volume in the drive with the next one in the 
kit. 

After you restore the VMS files, the procedure displays the following 
message: 


You may now remove the VMS distribution kit from ddcu:. 
Remove the VMS distribution media from the drive. 

If you are not installing VMS DECwindows software, go to Section 7.4. 
If you are installing VMS DECwindows software, the procedure 
displays the following message: 

Put the DECwindows distribution kit in the drive. 

* Enter name of drive holding the DECwindows distribution media: 

If you have either an RLO2 or RKO7 kit, VMS DECwindows is on 
magnetic tape. If you have an RX33 kit, VMS DECwindows is 


on a tape cartridge. Check the labels and place the appropriate 
piece of media on the appropriate drive. 
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Insert the VMS DECwindows distribution media. Then enter the 
device name of the drive. The procedure displays the following 
message: 


* Is the DECwindows media ready to be mounted? [N] 
Type Y (for YES) and press RETURN. 
The procedure displays messages similar to the following: 


$MOUNT-I-MOUNTED, DECW53 mounted on _MUAO: 


Restoring DECwindows applications save set... 
%$BACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows device support save set... 
SBACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows 75DPI fonts save set... 
%BACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows 100DPI fonts save set... 
$BACKUP-I-STARTVERIFY, starting verification pass 


Restoring DECwindows programming support save set... 
SBACKUP-I-STARTVERIFY, starting verification pass 


You may now remove the DECwindows distribution kit from MUAO: 


5 Remove the VMS DECwindows distribution media from the drive. 


7A) Upgrade Phase 3 


At the beginning of Phase 3, the procedure displays a message similar to 
the following: 


Continuing with VAX/VMS V5.3, Upgrade Procedure 


Upgrade Phase 3 19-APR-1990 16:45:18.35 


During Phase 3, the upgrade procedure does the following: 


Merges the VMS-distributed files that are commonly edited by system 
managers with new VMS files. 


Merges all the miscellaneous user files in the old system directories 
into a new set of system directories, temporarily called SYSF.SYSEXE, 
SYSE.SYSMGR, SYSE.SYSLIB, and so on. 


Removes the directory entries for page, swap, dump, and authorization 
files from the old directory tree. 


Deletes all the remaining accounting data files, operator logs, and all 
files in the SYSERR directory. 


Merges the old and new versions of the following files: HELP, 
DCLTABLES, IMAGELIB.OLB, and STARLET.OLB. 


Moves all remaining files from the old directory tree [VMS$COMMON] 
to the new directory tree. 


Deletes the old directory tree [VMS$COMMON]. 


During Phase 3, the system may display LIBRAR-E-DUPGLOBAL errors 
and file-not-found messages which you can ignore. 
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7.5 Upgrade Phase 4 


At the beginning of Phase 4, the procedure displays a message similar to 
the following: 


Continuing with VAX/VMS V5.3 Upgrade Procedure. 
Upgrade Phase 4 19-APR~1990 17:14:34.12 


During Phase 4, the upgrade procedure does the following: 
1 Corrects back pointers for system directories. 
2 Shuts down the system. 


3 You must manually reboot the system from the original system root 
(usually SYSO). 


If you are upgrading a VAX 8530, 8550, 8810, or 8820-N computer, do 
the following: 


a. Restore the original copies of DEFBOO and dddGEN to boot from 
the original root directory. 


b. In the pre-upgrade procedure (Chapter 5), you made copies of 
the boot command procedures, DEFBOO.SAV and dddGEN.SAV. 
To restore the original names to these files, enter the following 
commands and press RETURN after each one: 


>>> EXIT 
$ COPY DEFBOO.SAV DEFBOO.COM 
$ COPY dddGEN.SAV dddGEN.COM 


For most MicroVAX and VAXstation computers, use the BOOT 
command in the following format and substitute the device name 
of the system disk for ddcu: 


27> B ddcu 


For more information on booting the system, see the installation and 
operations guide for your VAX computer. 


4 After the system boots, the procedure displays a message similar to 
the following: 


VAX/VMS Version BC53-xxx Major version id = 1 Minor version id = 0 





7.6 Upgrade Phase 5 


At the beginning of Phase 5, the procedure displays a message similar to 
the following: 


Continuing with VAX/VMS V5.3 Upgrade Procedure. 
Upgrade Phase 5 , 19-APR-1990 17:45:24.03 

During Phase 5, the upgrade procedure does the following: 

e Displays messages about licenses which you can ignore. 

e Deletes the temporary [SYSF] directory tree. 

¢ Cleans up files used only during the upgrade procedure. | 
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Converts all VAXVMSSYS.PAR parameter files found in system roots 
to Version 5.3 format. 


Checks the security of DECnet—VAX objects and images. 


Displays messages listing tasks that you might want to perform after 
the upgrade procedure is completed. Chapter 8 explains these tasks. 





7.7 Upgrade Phase 6 


At the beginning of Phase 6, the procedure displays a message similar to 
the following: 


Continuing with VAX/VMS V5.3 Upgrade Procedure. 


Upgrade Phase 6 19-APR-1990 18:09:38.14 


During Phase 6, the upgrade procedure configures all devices on the 
system and runs AUTOGEN: 


1 


AUTOGEN runs and displays the following series of messages: 


Running AUTOGEN to compute the new SYSGEN parameters. 


An attempt may be made to re-size the pagefile or swapfile. If 
there is insufficient room on the disk, the recommended size is 
displayed with a message that the file should be created or 
extended manually by the system manager later on. 


Running AUTOGEN - Please wait. 


If the procedure displays a message similar to the following, see the 
Guide to Maintaining a VMS System for information on setting the 
sizes of the PAGE, SWAP, and DUMP files. 


KRHKKEKKKKKKKAEKKKREKK 


SAUTOGEN-W-DSKSPC, The disk on which DISKSVAXVMSRLS5: [SYSO.SYSEXE] PAGEFILE.SYS 
resides would be over 95% full if it were modified to hold 20000 
blocks. 


kaka KKKKKKKKKKKKKK 


After AUTOGEN finishes, the procedure displays a sequence of 
shutdown messages that begins like this: 


The system is shutting down to allow the system to boot with the generated 


‘site~specific parameters and installed images. | 


The system will automatically reboot after the shutdown and the 
upgrade will be complete. 


SHUTDOWN -- Perform an Orderly System Shutdown 


After AUTOGEN is complete, the system shuts down and may 
automatically reboot (if your system is set up to do so). If the 

system does not automatically reboot, reboot it manually. For more 
information on booting your system, see the installation and operations 
guide for you VAX computer. 
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4 Ifyou are upgrading a standalone system, skip this step. If you are 
upgrading a VAXcluster system, the system might hang when you try 
Ane to reboot the upgraded system disk. This is because the total cluster 
votes is less than the cluster quorum value. To remedy this situation, 
boot voting nodes that run from the system disk you just upgraded. 


5 After the system reboots, the procedure displays the following message: 


KKEKKKKKKREKKEKEKE KEKE KEKEKKKKKEEKRKREKREKEKKREKRRERKREKKREKKKRRKRKRKRKKKKKKKRKRKRKRKKR KK 


VAX/VMS V5.3 
You have SUCCESSFULLY installed the VMS operating system. 


The system is now executing the STARTUP procedure. Please 
await the completion of STARTUP before logging into the 
system (approximately three minutes). 


KEKKKAKKKEKEKEKKK KK EEK KKK EKER KEK KEKE KER EEK EKER KKREKEKKEKKKKKEKKKKKRKRKKRKRKKKKEK 


Finally, the procedure displays informational messages as well as 
accounting information. For example: 
Startup processing continuing... 


%SET-I-INTSET, login interactive limit=64, current interactive value = 0 
19-APR-1990 13:00:00.00 


SYSTEM job terminated at 19-APR~1990 13:00:00.00 
Accounting information: 

Buffered I/O count: 133. Peak working set size: 401 
Direct I/O count: 12 Peak virtual size: 2379 
Page faults: 325 Mounted volumes: 0 
Charged CPU time 0 00:00:55.23 Elapsed time 0 00:01:31.24 


At this point the VMS operating system is running. 


6 Press RETURN. The system asks for the user name and password. 
Log in to the SYSTEM account so that you can perform certain post- 
procedures procedures. 


Welcome to VAX/VMS V5.3 
USERNAME: SYSTEM 
PASSWORD: 


5 er { Oo + ent ay ) : 


Welcome to VAX/VMS V5.3 


If you forget the password, follow the instructions for performing an 
emergency startup in Guide to Setting Up a VMS System. 


Chapter 8 explains the post-upgrade tasks you must complete. 
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8 After You Do an Upgrade 


After you have upgraded the VMS operating system, you need to perform 
several important tasks before you can use the system. This chapter tells 
you what the tasks are, whether they are optional or required, and the 
order in which you perform them. The following list summarizes the tasks 
described in this chapter: 


1 
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Replacing SYSUAF.DAT 

Examining your command procedures 
Changing MODPARAMS.DAT 
Running DECnet—VAX 

Updating your console media 


Decompressing the system libraries 


‘Testing the system with UETP 


Removing unwanted files and checking the sizes of system files 
Customizing and starting VMS DECwindows software 


10 Building standalone BACKUP 
11 Backing up the system disk 
12 Running AUTOGEN 


8.1 Replacing SYSUAF.DAT 


If you permanently store SYSUAF.DAT on the system disk, skip this 
/ section and go to Section 8.2. | 


If you do not permanently store SYSUAF.DAT on the system disk, 

you copied it to the system disk before you did the upgrade. The 
upgrade procedure updates SYSUAF.DAT. Copy this updated version 

of SYSUAE.DAT from the system disk to the directory where you usually 
keep it. 


Note: If you did a rolling upgrade, the shared version of SYSUAF.DAT 
was not updated. | 


8.2 Examining Your Command Procedures 


The upgrade procedure places the latest versions of the following command 
procedures on your system disk: 
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[SYSMGR] DECWSSYLOGIN.COM 
~{SYSMGR]LTLOAD.COM ~ 
~=s~[SYSMGR] RTTLOAD.COM 
——~>[SYSMGR] STARTNET.COM ~ 

—_-2[SYSMGR] SYLOGIN.COM - 

——>, [SYSMGR] SYSTARTUP_V5.COM ~ 
—2{SYSMGR] SYCONFIG.COM — 
—+>[SYSMGR] SYSHUTDWN.COM*~ 
2 [SYSMGR] SYPAGSWPFILES.COM~ 
—sf SYSMGR] SYLOGICALS.COM 


Examine the old versions of these files before you purge them. Your old 
versions may have site-specific changes you want to save. For example, 
as part of your site-specific startup procedure you might install a page file 
on a disk other than the system disk. Edit the new versions of the files as 
necessary. 


8.3 Changing MODPARAMS.DAT 


Review the file SYS$SYSTEM:MODPARAMS.DAT. The upgrade 

procedure created a new version of this file. The old version is named 

SYS$SYSTEM:MODPARAMS.DAT_OLD. Modify the new file, if necessary, 
Vv for your system. 


If you are upgrading a VAXcluster, you must update the 
MODPARAMS.DAT file for each VAX computer that boots from the system 
disk. Make sure the EXPECTED_VOTES value is correct. The value is 
the sum of all VOTES in the cluster. For example, if there are five VAX 
computers in the cluster, and each has one VOTE, the value is five. As you 
reboot each VAX computer, AUTOGEN runs automatically. The cluster 
forms when you have booted enough computers to attain cluster quorum. 


8.4 Running DECnet—VAX 


If you are not running DECnet—VAX, skip this section and go to 
Section 8.5. 


If you are running DECnet—VAX, follow the instructions in Section 8.4.1 
and Section 8.4.2. 


(8.4.1, Running NETCONFIG_UPDATE.COM 


{ 
. NETCONFIG_UPDATE.COM is a new command procedure that 
| implements several security measures that affect default access to your 
/ - gystem. When you run NETCONFIG_UPDATE.COM your configuration 
database does not change, except for the changes you may make to the 
default DECNET account or the accounts you may create for specific 
objects. You can run this procedure whenever you want to change default 
access on your system. 


NETCONFIG_UPDATE.COM generates passwords for each account 
that you decide to keep in your configuration database. For example, 
if you currently have a default DECNET account and decide to keep 
it, NETCONFIG_UPDATE.COM generates a new password for it and 
replaces the existing password with the new one. 
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The following steps show an example of running NETCONFIG_ 
UPDATE.COM: 


1 Enter the following command: 


$ @SYSSUPDATE:NETCONFIG UPDATE 
The procedure displays the following message: 


DECnet--VAX node configuration upgrade procedure 


This procedure will allow you to create, display and 
optionally execute the necessary commands to update your 
executor and object database characteristics so that 
they will be compatible with V5.3 of DECnet--VAX. 


Getting Executor Information 
Getting Object Information 


Modifying Executor node 6.36 (KRUP) 
Do you wish a default nonprivileged DECnet account? [NO]: 


The default DECnet account, named DECNET, allows all network 
objects general access to the system. It is only appropriate for 
networks with very low security requirements. For networks with 
greater security requirements, Digital recommends separate default 
accounts for specific network objects. After you respond to this prompt, 
the procedure displays the following message: 


Do you wish to disable the TASK object? [YES]: 


The TASK object, by means of the default DECnet account (DECNET), 
allows user-written command procedures—including those which 
might be used in attempted break-ins—to be executed on your system. 
You can disable default access to the TASK object and still allow 
remote user-written command procedures to run on your system by 
using access control strings or proxy access. After you respond to this 
prompt, the procedure displays the following message: 


Do you want a default account for the MAIL object? [YES]: 


MAIL is an image that provides personal mail services for VMS 
systems. To receive MAIL, you must create a default account for the 
MAIL object. An account named MAIL$SERVER will be created on 
your system if you reply YES to this query. After you respond to this 
prompt, the procedure displays the following message: 


Do you want a default account for the FAL object? [NO]: 


FAL (File Access Listener) is the remote file access facility. FAL is 
an image that receives and processes remote file access requests for 
files at the local node. A default account for FAL allows network 
access, by any remote user, to any files marked world-accessible. It 
also allows any remote user to create files in any directory with world 
WRITE access. An account named FAL$SERVER will be created on 
your system if you reply YES to this query. After you respond to this 
prompt, the procedure displays the following message: 


Do you want a default account for the PHONE object? [YES]: 
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-6 PHONE is an image that allows online conversations with users on 


remote VMS systems. A default account for this object lets anyone in 
the network get a list of users currently logged in to the local system. 
A user can then attempt a login using the list of user names. An 
account named PHONES$SERVER will be created on your system if 
you reply YES to this query. After you respond to this prompt, the 
procedure displays the following message: 


Do you want a default account for the NML object? [YES]: 


7 NML is the Network Management Listener. A default account for this 
object lets remote users issue NCP TELL commands to gather and 
report network information from your volatile DECnet—VAX databases. 
An account named NML$SERVER will be created on your system if 
you reply YES to this query. After you respond to this prompt, the 
procedure displays the following message: 


Do you want a default account for the VPM object? [YES]: 


8 VPM is the VMS Performance Monitor. To use the cluster monitoring 
features of the Monitor Utility (MONITOR), you must create a default 
VPM account. An account named VPM$SERVER will be created on 
your system if you reply YES to this query. After you respond to this 
prompt, the procedure displays the following message: 


Do you want a default account for the MIRROR object? [YES]: 


9 MIRROR is an image that is used for most types of loopback tests, 
including those run during the DECnet phase of the User Environment 
Test Program (UETP). To run most loopback tests, you must create 
a default account for the MIRROR object. An account named 
MIRRO$SERVER will be created on your system if you reply YES 
to this query. 


10 Next the procedure displays a series of commands and the following 
message: 
Do you wish to execute these commands now? [YES]: 


11 If you execute the commands, the procedure displays the following 
message: 


The DECnet--VAX database has been updated 


For a description of the network configuration procedure, | 
NETCONFIG.COM, refer to the Guide to DECnet-VAX Networking 

or to the VMS Networking Manual. For information on the security 
enhancements to NETCONFIG.COM, refer to the VMS Version 5.2 New 
Features Manual. 


8.4.2 Running UPDATE_CLUSTER_MEMBERS.COM 


oO 


When you run NETCONFIG_UPDATE.COM on a member of a VAXcluster 
environment, the NETCONFIG_UPDATE.COM procedure creates the 
secondary procedure named SYS$COMMON:[SYSMGR]UPDATE_ 
CLUSTER_MEMBERS.COM. NETCONFIG_UPDATE.COM instructs 

you to ran UPDATE_CLUSTER_MEMBERS.COM on the other VAXcluster 
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members. This secondary procedure modifies the default access of each 
VAXcluster member exactly as you modified that of the first member. 


To run UPDATE_CLUSTER_MEMBERS.COM using SYSMAN, do the 
following: 


S$ RUN SYSSSYSTEM: SYSMAN 
SYSMAN> SET ENVIRONMENT/CLUSTER/USER=SYSTEM 
Remote Password: 


%$SYSMAN-I-ENV, current command environment: 
Clusterwide on local cluster 
Userman SYSTEM will be used on nonlocal nodes 
SYSMAN> DO @SYSSCOMMON: [SYSMGR] UPDATE_CLUSTER_MEMBERS . COM 
SYSMAN> EXIT 


8.5 Updating Your Console Media 


If your computer does not use console media, skip this section and go to 
Section 8.6. 


If your computer uses console media, you must copy the Version 5.3 
VMB.EXE onto your system’s console media. Section 8.5.1 describes the 
procedure to use if you have a VAX 8530, 8550, 8700, 8800, 8810, or 
8820-N. 


Section 8.5.2 describes the procedure to use if you have one of the following 
computers: _ acne 


Mepeginalieae 


VAX 8200, 8250, 8300, 8350 
VAX 8600, 8650 





8.5.1 VAX 8530, 8550, 8700, 8800, 8810, 8820-N 


op 


If you have a VAX 8530, 8550, 8700, 8800, 8810, or 8820-N, follow the 
directions in this section. 


1 Place a blank RX50 diskette in one of the console diskette drives. The 
console refers to the upper (or left-hand) diskette drive as DZ1 while 
the VMS operating system refers to it as CSA1. The console refers 
to the lower (or right-hand) drive as DZ2 while the VMS operating 
system refers to it as CSA2. 


2 Make sure the diskette drives have been connected to the VMS 
operating system, as follows: 


S$ SHOW DEVICE CSA 


Device Device Error Volume 
Name Status Count Label 
CSA0: (SYSTEM) Online 0 
CSA1: (SYSTEM) Online 0 
CSA2: (SYSTEM) Online 0 


If the drives are not connected, the following message is displayed: 


%SYSTEM-W-NOSUCHDEV, no such device available 
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10 


11 


If this message is displayed, enter the following commands (you need 
CMKRNL privilege): 


S$ RUN SYSSSYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 


To initialize the diskette, enter a command in the following format and 
press RETURN: 


S INITIALIZE/STRUCTURE=1 device-name: volume-label 


Substitute CSA1 or CSA2 for device-name. Substitute a 1- to 
12-character name for volume-label. For example: 


$ INITIALIZE/STRUCTURE=1 CSA1: V53CONSOLE 


Enter the following commands to mount the diskette, create the 
required directories, and copy the new VMB.EXE to the diskette. 
Substitute CSA1 or CSA2 for device-name. 


$ MOUNT/OVERRIDE=ID device-name: 
$ CREATE/DIRECTORY device-name: [TRANSFER] : 
S$ COPY SYSSSYSTEM:VMB.EXE device-name: [TRANSFER] 


Once you have copied all the files, enter the following command to 
dismount the diskette. Substitute CSA1 or CSA2 for device-name. 


$ DISMOUNT device-name: 


‘To enter console mode, press CTRL/P. To exit from the console program, 


enter the following command and press RETURN: 
>>> EXIT 


Open the diskette drive door, pause for a moment, and close it. The 
red indicator light should flash. 


To copy VMB.EXE from the diskette to the console fixed disk drive, 
enter the following command and press RETURN: 


$ COPY DZu:[TRANSFER]VMB.EXE  LBO: [CONSOLE] 
Substitute DZ1 or DZ2 for DZu. 


The fixed drive in the console is known by two names, DW2 and 
LBO. Most console files are stored using the name LBO. If the system 
displays a message that describes a protection violation on the output 
device, copy the files using the device name DW2. 


When you have finished copying the files, remove the diskette from the 
drive. 

Restart the console program by entering the following command and 
pressing RETURN: 

$ RUN CONTROL 


Return to the VMS operating system by entering the following 
command and pressing RETURN: 


>>> SET TERM PROGRAM 


at say 
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8.5.2 VAX 11/730, 750, 760, 785 and VAX 8200, 8250, 8300, 8350, 8600, 8650 


nef 
If you have one of the following VAX computers, follow the directions in 
this section: 


VAX-—11/730 

VAX—11/750 

VAX-11/780, 785 

VAX 8200, 8250, 8300, 8350 
VAX 8600, 8650 


This procedure does the following: 


Checks to see if you have enough space for the new VMB 
Copies the new VMB to the console media 


Updates the BOOTS58 file for the VAX 11/750, 8200, 8250, 8300 and 
8350 computers 


To update the console media, use the following procedure: 


/ 1 
2 


y 


Log into the SYSTEM account. 


Enter the following commands to check if there is enough space for 
the new VMB.EXE. You need 75 free blocks. If you are updating a 
VAX—11/730, use CSA2 for device-name; if you are updating one of the 
other VAX computers, use CSA1 for device-name. 


$ RUN SYSSSYSTEM: SYSGEN 

SYSGEN> CONNECT CONSOLE 

SYSGEN> EXIT cease 

$ EXCHANGE DIRECTORY device=name:VMB.EXE 


Directory of RT-11 volume TINESSCSAIL1: 19-APR-1990 14:04 
VMB . EXE 64 19-Apr-1990 
Total of 1 file, 64 blocks. Free space 23 blocks, largest 16. 


If the size of the current VMB, plus the free space, does not equal at 
least 75 blocks, delete unneeded files on the console until you have 
75 blocks available. In the above example, 87 blocks are available, so 
files do not have to be deleted. 


Enter the following command and press RETURN: 
$ @SYSSUPDATE:UPDATE CONSOLE.COM 


If you are updating a VAX 8600 or 8650 computer, the new VMB.EXE 
is copied onto the console. 


If you are updating one of the other VAX computers, the procedure 


uses the EXCHANGE procedure to copy the contents of the existing 
console, merge the new files onto the copy of the console, and create 
a new version of the console media. When the computer is ready to 
create the new version, it displays a message asking you to insert a 
scratch tape cassette or diskette. Take out the original console media 
and insert a new one. 
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8.6 Decompressing the System Libraries 


Decompressing the system libraries gives the system faster access to | 

the libraries. The decompressed libraries require approximately 8000 
additional blocks of disk space. To find out how much disk space you have, 
enter the following command and press RETURN: 


S$ SHOW DEVICE SYSSSYSDEVICE 


If you have enough room on the disk, you can decompress the libraries. 
The decompression process takes approximately 30 minutes. Log into the 
SYSTEM account, enter the following command, and press RETURN: 


S$ @SYSSUPDATE : LIBDECOMP 


8.7 Testing the System with UETP 


Run the User Environment Test Package (UETP) to verify that the 
upgrade was done correctly. For instructions on running UETP, see 
Chapter 9. 


8.8 Increasing Free Space on the System Disk 


Read this section if you want to remove some of the VMS operating system 
and DECwindows files that you do not need from the system disk and if 
you want to change the size of some system files. 


8.8.1 Using VMSTAILOR 


To remove unwanted VMS files from the system disk, use VMSTAILOR. 
For example, if you are not running DECnet—VAX, you do not need the 
network support files. To remove unwanted files with the VMSTAILOR 
program, do the following: 


1 Log in to the SYSTEM account. 

2 Enter the following command, and press RETURN: 
$ RUN SYS$UPDATE:VMSTAILOR 
VMSTAILOR displays the following message: 


Do you want to tailor files "ON" or "OFF"? 
3 Type OFF to remove unwanted files. 


The VMSTAILOR program lists each group of files and its size in 
blocks. Files are grouped according to their function. For example, all 
the files required for network support are in one group. A file group | 
is made up of many small subgroups. You can eliminate an entire 
group of files, or you can eliminate one or more of its subgroups. For 
example: 


Note: 
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CLASS - Network support 
Size of entire class (with subclasses): 1478 
Size of common files required for any subclass: 1233 
Do you wish to select the entire class (default = NO)? 


Decide which file groups or subgroups you do not need to support your 
system. The VMSTAILOR program displays step-by-step instructions. 


VMSTAILOR displays the names of the files it deletes. After it 
finishes, AUTOGEN runs automatically to make the adjustments 
that are necessary after system files are deleted. AUTOGEN also 
reboots the system. 


You can use VMSTAILOR at any time to delete or add groups 
of VMS files to the system disk. After adding files to the system 
disk, you should apply any updates that affect them. 


For example, suppose you do not need the VMS Version 5.3 
PHONE utility and you run VMSTAILOR to remove those 
files. Later on, if you decide you want to use PHONE, you 
can run VMSTAILOR to return the PHONE files to the system 
disk. You then apply any VMS update that has occurred since 
Version 5.3 that affected the PHONE utility. VMS update 
procedures create a .TXT file that. contains a description 

of patched files. This file usually has the following format: 
SYSSUPDATE:VMSUn053.TXT. 


8.8.2 Using DECWS$TAILOR 


To remove unwanted DECwindows files from the system disk, use 
DECWS$TAILOR. For example, if you are not planning on utilizing the 
DECwindows programming support, you can remove those files. To remove 
DECwindows files from the system disk, do the following: 


0 
\U 


1 
2 


Log in to the SYSTEM account. 
Enter the following command, and press RETURN: 


$ RUN SYSSUPDATE:DECWSTAILOR 
DECW$TAILOR displays the following message: 


Do you want to tailor files "ON" or "OFF"? 
Type OFF to remove unwanted files. 


The DECW$TAILOR program lists each group of files and its size in 
blocks. Files are grouped according to their function. For example, 
all the files required for VMS DECwindows user support are in one 
group. A file group is made up of many small subgroups. You can 
eliminate an entire group of files, or you can eliminate one or more of 
its subgroups. For example: 
CLASS ~ DECwindows user support files 

Size of entire class (with subclasses): 8456 


No subclasses in this tailor class. 
Do you wish to select the entire class (default = NO)? 
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4 Decide which file groups or subgroups you do not need to support 
your system. The DECW$TAILOR program displays step-by-step 
instructions. 


When tailoring VMS DECwindows files, consider the following: 


Note: 


Applications filese—VMS DECwindows provides a variety of 
applications; including the following: Bookreader, Calculator, 
Calendar, Cardfiler, Clock, DDIF Document Viewer, EVE Text 
Editor, FileView, Mail, Notepad Text Editor, Paint Graphics Editor, 
DECterm, the Session Manager, and the Icon Box. If you are 
installing VMS DECwindows on a VAXstation, you need these 
files. You may also want these files on a nonworkstation VAX 
computer, because you can run VMS DECwindows applications 

on a nonworkstation VAX computer and display them on a> 
workstation. 


Device support files—If you are installing VMS DECwindows on 
a VAXstation or in a cluster that includes VAXstations, you need 
these files. Otherwise you do not need them. 


If you tailor device support files ON or OFF, the system 
reboots. 


100 dots-per-inch (100DPI) video font files—If you have a 
workstation monitor capable of displaying 100 dpi (for example, 

a VR150, VR160, or VR295), selecting 100 dpi fonts will give 

you a more readable display when you run VMS DECwindows 
applications. If your workstation monitor cannot display 100 dpi 
fonts (for example, a VR260 or VR290), you can save disk space by 
not selecting this option. For more information on the capabilities 
of your particular monitor, see the owner’s guide for your monitor, 


Programming support files—The VMS DECwindows programming 
support files are needed only to develop applications and are | 
not required to run VMS DECwindows applications. Support 
files are supplied for the following VAX programming languages: 
Ada, BASIC, BLISS, C, FORTRAN, MACRO, Pascal, and PL/1. 
In addition, support files are: supplied for programming in the 

C language using conventions and standards developed at the 
Massachusetts Institute of Technology. 


5 DECWS$TAILOR displays the names of the files it deletes. If you 
deleted device support files, AUTOGEN runs automatically and reboots 
the system. 


8.8.3 Checking the Size of System Files 
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You also can change the sizes of some files to increase free disk space. The 


size of the following files may have been changed to fit the system. Check 
these files to be sure that the sizes are appropriate. 


[SYSEXE] SYSDUMP . DMP 
[SYSEXE] PAGEFILE.SYS 
[SYSEXE] SWAPFILE.SYS 
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To modify the size of these files, log into the SYSTEM account and enter 
the following command and press RETURN: 


$ @SYSSUPDATE: SWAPFILES 
You might want to purge the following VMS files: 


SYSSSYSTEM: SHUTDOWN .COM 
SYSSSYSTEM: STARTUP .COM 
SYSSLIBRARY : ENCRYPSHR.EXE 
SYSSLIBRARY: *RTL* .EXE 
SYSSLIBRARY: *SHR.EXE 
SYSSMANAGER: EDTINI.EDT 
SYSSMANAGER : DBLSTRTUP .COM 
SYSSMANAGER: LOGIN. COM 
SYSSMANAGER: SYSTARTUP_V5.COM 
SYSSMANAGER: TFF$STARTUP .COM 
SYSSMANAGER : WELCOME. TXT 
SYSSMANAGER: * . TEMPLATE 
SYSSEXAMPLES : XADRIVER.MAR 
SYSSLIBRARY : CDDSHR. EXE 
SYSSLIBRARY: EPCSSHR.EXE 
SYSSLIBRARY : EPCSFACILITY.TLB 
SYSSLIBRARY : EPCSMSG.EXE 
SYSSLIBRARY : UISSHR.EXE 
SYSS$STARTUP : VMSSLAYERED .DAT 


8.9 Starting and Customizing VMS DECwindows Software 


If you have installed VMS DECwindows software, there are several 
steps that you must take to start and customize the VMS DECwindows 
environment. Chapter 10 describes these steps. After you finish starting 
and customizing VMS DECwindows software, return to this chapter. 


8.10 Backing Up the System Disk 


Protect your work by making a backup copy of the upgraded system disk. 
Digital recommends that you also perform the following operations: 


¢ Make a standalone BACKUP kit 
¢ Back up the console media (if applicable) 


For complete information on these operations, see the VMS installation 
and operations guide for your VAX computer. 


8.11 Running AUTOGEN 


Run AUTOGEN FEEDBACK and reboot the system after 24 hours of 
operation, and again, 2 workdays later. AUTOGEN sets the values of 
system parameters and the sizes of the page and swap files according 
to the system’s workload. Digital recommends that you run AUTOGEN 
from SAVPARAMS through TESTFILES on a weekly basis and examine 
AGEN$FEEDBACK.REPORT to determine the need for additional 
changes. 
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Hardcoded values in MODPARAMS.DAT affect AUTOGEN’s calculations 
of the feedback parameters. For AUTOGEN FEEDBACK to properly 
calculate values, you should replace the hardcoded values in 
MODPARAMS.DAT with MIN_ values. 


For information on using AUTOGEN, see the Guide to Setting Up a VMS 
System. | 


9 Running UETP 


The User Environment Test Package (UETP) is a VMS software package 
designed to test whether the VMS operating system is installed correctly. 
UETP puts the system through a series of tests that simulate a typical 
user environment, by making demands on the system that are similar to 
demands that might occur in everyday use. 


UETP is not a diagnostic program; it does not attempt to test every feature 
exhaustively. When UETP runs to completion without encountering 
nonrecoverable errors, the system being tested is ready for use. 


UETP exercises devices and functions that are common to all VMS 
systems, with the exception of optional features such as high-level 
language compilers. The system components tested include the following: 


¢ Most standard peripheral devices 
e The system’s multiuser capability 
¢ DECnet—VAX 


¢ Clusterwide file access and locks 


9.1 Summary of UETP Operating Instructions 


This section summarizes the procedure for running all phases of UETP 
with default values. If you are familiar with the test package, refer to this 
section. If you need further information, refer to Section 9.2. 


1 Log in to the SYSTEST account as follows: 


Username: SYSTEST 
Password: 


Note: Because the SYSTEST and SYSTEST_CLIG accounts have 
privileges, unauthorized use of these accounts might 
compromise the security of your system. | 


2 Make sure no user programs are running and no user volumes are 
mounted. By design, UETP assumes and requests the exclusive use of 
system resources. Unpredictable results could occur if you ignore this 
restriction. 


3 After you log in, check all devices to be sure that the following 
conditions exist: | 


e All devices you want to test are powered up and are on line to the 
system. 


e Scratch disks are mounted and initialized. 


e Disks contain a directory named [SYSTEST] with OWNER_ 
UIC=[1,7]. (You can create this directory with the DCL command 
CREATE/DIRECTORY.) 
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Note: 


e Scratch magnetic tape reels are physically mounted on each drive 
you want tested and are initialized with the label UETP (using 
the DCL command INITIALIZE). Make sure magnetic tape reels 
contain at least 600 feet of tape. | 


e Scratch tape cartridges have been inserted in each drive you want 


to test and are initialized with the label UETP. 
e Line printers and hardcopy terminals have plenty of paper. 


e Terminal characteristics and baud rate are set correctly (see the 
user’s guide for your terminal). 


Note that some communications devices need to be set up by Digital 
Customer Service (see Section 9.3). 


If you encounter any problems in preparing to run UETP, read 
Section 9.3 before proceeding. 


To start UETP, enter the following command and press RETURN: 
$ QUETP 

UETP responds with the following question: 

Run "ALL" UETP phases or a "SUBSET" [ALL]? 


Press RETURN to choose the default response enclosed in brackets. 
UETP responds with three more questions in the following sequence: 


How many passes of UETP do you wish to run [1]? 
How many simulated user loads do you want [n]? 
Do you want Long or Short report format [Long]? 


Press RETURN after each prompt. After you answer the last 
question, VETP initiates its entire sequence of tests, which run to 
completion without further input. The final message should look like 
the following: 
KKEKEKKKKKKEKEKKKEKKEKKEKKEKKKKEKKKRKEKEKKEKREKKEKKKRKRKKKKKKRKEKK 

* * 


END OF UETP PASS 1 AT 19-APR-1990 16:30:09.38 
* x 
FOO IU IOI III III IOI OI I III IO I III OK 


After UETP runs, check the log files for errors. If testing completes 
successfully, the VMS operating system is in proper working order. 


After a run of UETP, you should always run the Error Log 
Utility to check for hardware problems that can occur during a 
run of UETP. For information on running the Error Log Utility, 
refer to the VMS Error Log Utility Manual. | 


If UETP does not complete successfully, refer to Section 9.5. 


If you want to run UETP without using the default responses, refer to 
Section 9.4 through Section 9.4.4, which explain the options. 


Running UETP 
9.2 Logging In 





9.2 Logging In 


This section contains detailed instructions on running UETP. For a brief 
summary of these steps, see Section 9.1. 


Obtain the SYSTEST password from your system manager. Log into the 
SYSTEST account from the console terminal as follows: 


Username: SYSTEST 
Password: 


Note: Because SYSTEST has privileges, unauthorized use of this account 
might compromise the security of your system. 


UETP will fail if you do not run the test from the SYSTEST account. Also, 
if you try to run UETP from a terminal other than the console terminal, 
the device test phase displays an error message stating that the terminal 
you are using is unavailable for testing. You can ignore this message. 


After you log into the SYSTEST account, enter the command SHOW 
USERS to make sure no user programs are running and no user volumes 
are mounted. UETP requires exclusive use of system resources. If you 
ignore this restriction, UETP may interfere with apyncenins that depend 
on these resources. 


9.2.1 SYSTEST Directories 


If you logged in successfully, you should be in the root directory [SYSTEST] 
on the system disk. UETP uses directories named [SYSTEST] to hold all 
the files used by UETP command procedure (UETP. COM) and temporary 
files used by UETP during testing. 


The DCL command SHOW LOGICAL displays the translation of the 
logical name SYS$TEST on a typical system: 


$ SHOW LOGICAL SYSSTEST 
"SYSSTEST" = "SYSSSYSROOT: [SYSTEST]" (LNMSSYSTEM_TABLE) 


If you want UETP to test a particular disk, such as a scratch disk, create 
either a [SYSTEST] directory or a [SYSO.SYSTEST] directory on that disk. 
Section 9.3.2 discusses setting up scratch disks for testing. 


9.3 Setting Up for UETP 


After you log in, you need to set up the devices on the system for UETP 
testing. 


Note: Your system may not have all the devices described in this section. 
You should check all devices to be sure that the following conditions exist: 
e All devices you want to test are turned on and are on line. 
¢ Scratch disks are mounted and initialized. 


¢ Disks contain a directory named [SYSTEST] with OWNER_UIC=([1,7]. 
Use the CREATE/DIRECTORY command if the [SYSTEST] directory 
does not exist on the disk. 
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e Scratch magnetic tape reels are physically mounted on each drive you 
want tested and are initialized with the label UETP (using the DCL 
command INITIALIZE). Make sure magnetic tape reels contain at 
least 600 feet of tape. 


e Scratch tape cartridges have been inserted in each drive you want to 
test and are mounted and initialized with the label UETP. 


e Line printers and hardcopy terminals have plenty of paper. 


e Terminal characteristics and baud rate are set correctly (see the user’s 
guide for your terminal). 


Note that some communications devices discussed in this section need to 
be set up by Digital Customer Service. 


9.3.1 Setting Up the System Disk 


Before running UETP, be sure that the system disk has at least 

1200 blocks available. Note that systems running more than 20 load test 
processes, May require a minimum of 2000 available blocks. If you run 
multiple passes of UETP, log files will accumulate in the default directory 
and further reduce the amount of disk space available for subsequent 
passes. 


If disk quotas are enabled on the system disk, you should disable them 
before you run UETP. 


9.3.2 Setting Up Additional Disks 


The disk test uses most of the available free space on each testable disk in 
the following manner: 


e On each testable disk, the device test phase tries to create two files. 
The size of these files depends on how much free space is available on 
the disk. Usually the test creates each file with 5% of the free space 
on the disk. However, if the disk is nearly full, the test creates files 
that are 5 blocks. If the test cannot create 5 block files, it fails. Only 
the initial file creation can cause the device test to fail because of lack 
of disk space. | 


e¢ The test randomly reads and writes blocks of data to the files. After 
every multiple of 20 writes for each file, the test tries to extend the 
file. The size of this extension is either 5% of the free disk space, or 
5 blocks if the file was created with 5 blocks. This process of extension 
continues until the combined space of the files reaches 75% of the free _ 
disk space. 


By creating and extending fragmented files in this way, UETP exercises 
the disk. This allows the test to check for exceeded quotas or a full disk, 
and to adjust for the amount of available disk space. 
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To prepare each disk drive in the system for UETP testing, use the 
following procedure: 


1 


Place a scratch disk in the drive and spin up the drive. If a scratch 
disk is not available, use any disk with a substantial amount of free 
space; UETP does not overwrite existing files on any volume. If your 
scratch disk contains files that you want to keep, do not initialize the 
disk; go to step 3. 


If the disk does not contain files you want to save, initialize it. For 
example: 


$ INITIALIZE DUAL: TEST1 


This command initializes DUA1, and assigns the volume label TEST1 
to the disk. All volumes must have unique labels. 


Mount the disk. For example: 


$ MOUNT/SYSTEM DUAL: TEST1 


This command mounts the volume labeled TEST1 on DUA1. The 
/SYSTEM qualifier indicates that you are making the volume available 
to all users on the system. 


UETP uses the [SYSTEST] directory when testing the disk. If the 
volume does not contain the directory [SYSTEST], you must create it. 
For example: 


$ CREATE/DIRECTORY/OWNER_UIC=[1,7] DUA1: [SYSTEST] 


This command creates a [SYSTEST] directory on DUAI and assigns a 
user identification code (UIC) of [1,7]. The directory must have a UIC 
of [1,7] to run VETP. 


If the disk you have mounted contains a root directory structure, you can 
create the [SYSTEST] directory in the [SYSO.] tree. 


9.3.3 Setting Up Magnetic Tape Drives 
Set up magnetic tape drives that you want to test by doing the following: 


1 


Place a scratch volume with at least 600 feet of magnetic tape in the 
tape drive. Make sure that the write-enable ring is in place. 


Position the magnetic tape at the perenne ene (BOT) and put the 
drive on line. 


Initialize each scratch magnetic tape with the label UETP. For 
example, if you have physically mounted a scratch magnetic tape 
on MTA1, enter the following command and press RETURN: 


$ INITIALIZE MTA1: UETP 


Magnetic tapes must be labeled UETP to be tested. As a safety 
feature, UETP does not test tapes that have been mounted with the 
MOUNT command. 
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If you encounter a problem initializing the magnetic tape, or if the test 
has a problem accessing the magnetic tape, refer to the description of the 
INITIALIZE command in the VMS DCL Dictionary. 


9.3.4 Setting Up Tape Cartridge Drives 
Set up tape cartridge drives that you want to test by doing the following: 
1 Insert a scratch tape cartridge in the tape cartridge drive. 
2 Initialize the tape cartridge. For example: 
$ INITIALIZE MUAO: UETP 
Tape cartridges must be labeled UETP to be tested. As a safety 


feature, UETP does not test tapes that have been mounted with the 
MOUNT command. 


If you encounter a problem initializing the tape cartridge, or if the test has 
a problem accessing the tape cartridge, refer to the description of the DCL 
INITIALIZE command in the VMS DCL Dictionary. 


9.3.5 Setting Up Terminals and Line Printers 


Terminals and line printers must be turned on to be tested by UETP. They 
must also be on line. Check that line printers and hardcopy terminals 
have enough paper. The amount of paper required depends on the number 
of UETP passes that you plan to execute. Each pass requires two pages 
for each line printer and hardcopy terminal. 


_ Check that all terminals are set to the correct baud rate and are assigned 
appropriate characteristics (see the user’s guide for your terminal). 


Spooled devices and devices allocated to queues fail the initialization phase 
of UETP and are not tested. 


9.3.6 Preparing Ethernet Adapters for UETP Testing 


Make sure that no other processes are sharing the device when you run 
UETP. | 


Note: UETP will not test your Ethernet adapter if DECnet-VAX or 
another application has the device allocated. 


9.3.7 Preparing the DR11—W for UETP Testing 


Note: Only Digital Customer Service personnel should set up the 
DR1I-W for UETP testing. 


The DR11-—W uses an internal logical loopback mode that tests all 
functionality except that of module connectors, cables, and transceivers. 
Because random external patterns are generated during this operation, the 
user device or other processor might need to be isolated from the DR11—W 
being tested until the testing is complete. 
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To test the DR11—W properly, the E105 switchpack must be set as follows: 
Switch 1 Switch 2 Switch 3 Switch 4 Switch 5 


Off On Off Off On 
When UETP testing is completed, restore the DR11—W to the proper 
operating configuration. 


9.3.8 Preparing the DRV11—WA for UETP Testing 


Note: Only Digital Customer Service personnel should set up the 
DRV11-WA for UETP testing. 


To prepare the DRV11—WA on a MicroVAX for UETP testing, be sure the 
following conditions exist: 


¢ The jumpers on the DRV11-WA board are set to W2, W3, and W6. 
¢ A loop-back cable is connected to the DRV11—WA board. 


¢ The DRV11-—WaA board is in a slot from 8 to 12. If the DRV11—WA is in 
a slot other than 8 to 12, you might get timeout errors. | 


When UETP testing is completed, restore the DRV11—WA to the proper 
operating configuration. 


9.3.9 Preparing the DR750 or the DR780 for UETP Testing 


Note: Only Digital Customer Service personnel should set up the DR750 
or DR780 for UETP testing. 


To prepare the DR750 or the DR780 for UETP testing, use the following 
procedure: | 


1 Copy the DR780 microcode file, XF780.ULD, from the diagnostic 
medium to SYS$SYSTEM. Use the procedure described in the 
documentation provided with the DR780 Microcode Kit. 


Turn off the power to the DR780. 
3 Make the following DR780 backplane jumper changes: 
e Remove the jumper from W7 and W8. 
e Add a jumper from E04M1 to E04R1. 
e Add a jumper from E04M2 to E04R2. 


4 Disconnect the DDI cable from the DR780. This cable is either a 
BCO6V-nn cable, which can be disconnected, or a BCO6R—nn cable, 
which requires that you remove its paddle card from the backplane of 
the DR780. | 


5 Restore power to the DR780. 


When UETP testing is completed, restore the DR750 or the DR780 to the 
proper operating configuration. 
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9.3.10 Preparing the MA780 for UETP Testing 


Be sure that the MA780 is set up according to the guidelines for shared 
memory in the Guide to Maintaining a VMS System. 


If you run the MA780 device test individually, the logical name 
CTRLNAME must be defined as MPM, regardless of the memory name. 
As an alternative, you can enter “MPM” in response to the controller 
designation prompt. | 


9.3.11 Preparing a Second LPA11—K for UETP Testing 


If you have two LPA11—Ks, be sure that each is given a systemwide logical 
name in the SYS$MANAGER:LPA11STRT.COM file. The logical name for 
the first LPA11—K should be LPA11$0, and the logical name for the second 
LPA11—K should be LPA11$1. 


9.3.12 Devices Not Tested 


UETP does not test the following devices; their status has no effect on 
UETP execution: 


e Devices that require operator interaction (such as card readers) 


e Software devices (such as the null device and local memory mailboxes) 


UVETP does not have specific tests for UDA, HSC, or CI devices; they are 
tested implicitly by the disk, magnetic tape, and DECnet—VAX tests. 


UETP also does not test the console terminal or console drives. If you boot 
the system, log in, and start UETP, you have shown that these devices can 
be used. 


9.3.13 Preparing for VAXcluster Testing 


Before you run UETP in a VAXcluster environment, you should check 
the SYSTEST_CLIG account. The SYSTEST_CLIG account parallels 
SYSTEST except that it is dedicated to running the cluster-integration 
test. The requirements for the SYSTEST_CLIG account are as follows: 


1 The account should be present in the user authorization file, exactly as 
distributed by Digital on each system in your VAXcluster. 


Note: The SYSTEST_CLIG account might have been disabled as 
part of the VMS upgrade procedure. If it was disabled, you 
should re-enable the SYSTEST_CLIG account and give it a null 
password before you run UETP. 


To re-enable the SYSTEST_CLIG account, enter the following 
commands and press RETURN after each one: 


Note: 


2 


Running UETP 
9.3 Setting Up for UETP 


$ SET DEFAULT SYSSSYSTEM 

$ RUN AUTHORIZE 

UAF> MODIFY /FLAGS=NODISUSER /NOPASSWORD SYSTEST_CLIG 
UAF> EXIT 


Digital recommends that you disable the SYSTEST_CLIG 
account after testing has completed. 


To disable the SYSTEST_CLIG account, enter the following commands 
and press RETURN after each one: 


$ SET DEFAULT SYSSSYSTEM 

$ RUN AUTHORIZE 

UAF> MODIFY /FLAGS=DISUSER SYSTEST CLIG 
UAF> EXIT 


The privileges and quotas of the SYSTEST_CLIG account should 
match those of the SYSTEST account. 


UETP requires little additional preparation for the cluster-integration 
test phase beyond the requirements for other UETP test phases. The 
additional requirements for cluster integration testing are as follows: 
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Your system must be a member of a VAXcluster. If it is not, UETP 
displays a message and does not attempt to run the test. © 


Your system must use the same deadlock detection interval as the 
other systems in the VAXcluster. | 


The files UETCLIGO0.COM and UETCLIGO0.EXE, located in 
SYS$TEST, are necessary for each system included in the test. 


DECnet—VAX must be set up between the VAXcluster nodes; UETP 
uses DECnet-VAX to create a process on those nodes. All checks that 
the test makes depend on its ability to create the SYSTEST_CLIG 
processes and to communicate with them using DECnet—VAX. 


There must be a [SYSTEST] or [SYSO.SYSTEST] directory on some 
disk available to the VAXcluster for each node (both VMS and HSC) in 
the cluster. The test uses the same directory as the UETP disk test to 
create a file on each cluster node and to see if some other VMS node 
in the cluster can share access to that file. There must be one such 


directory per node; the test continues with the next cluster node once 


it has finished with a file. 


9.3.14 Preparing a Small-Disk System 


After you install the VMS operating system on a small system disk (for 
example, an RD53), you may not have the 1200 blocks of free disk space 
required to run UETP successfully. If you do not have 1200 free blocks on 
your system disk, use VMSTAILOR to remove some files from the system 
disk before you run UETP. For instructions on using VMSTAILOR, see 
Chapter 3. 
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9.3.15 Preparing DECnet—VAX 


9.4 


Starting UETP 
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The DECnet—VAX phase of UETP uses more system resources than other 
tests. You can, however, minimize disruptions to other users by running 
the test on the “least busy” node. 


By default, the file UETDNET00.COM chooses the node from which the 
DECnet—VAX test will be run. To choose the node to run the DECnet-VAX 
test on, enter the following command before you invoke UETP: 


$ DEFINE/GROUP UETPSNODE_ADDRESS node_address 


This command equates the group logical name UETP${NODE_ADDRESS 
to the node address of the node in your area on which you want to run the 
DECnet—VAX phase of UETP. 


For example: 
$ DEFINE/GROUP UETPSNODE_ADDRESS 2.121 


When you run UETP, a router node attempts to establish a connection 
between your node and the node defined by UETP$NODE_ADDRESS. 
Occasionally, the connection between your node and the router node might 
be busy or non-existent. When this happens, the system displays the 
following error messages: 


&%NCP-F=<CONNEC, Unable to connect to listener 
-SYSTEM-F-REMRSRC, resources at the remote node were insufficient 


%NCP-F-CONNEC, Unable to connect to listener 
~SYSTEM-F-NOSUCHNODE, remote node is unknown 


When you have logged in and prepared the system and devices, you are 
ready to begin the test. 


To start UETP, enter the following command and press RETURN: 
$ QUETP 

UETP displays the following prompt: 

Run "ALL" UETP phases or a "SUBSET" [ALL]? 


Throughout the startup dialog, brackets indicate the default value, which 
you can choose by pressing RETURN. 


When running UETP for the first time, it is a good idea to choose the 
default value (ALL) and run all the phases. If you choose ALL, UETP 
displays three more questions, which are described in Section 9.4.2 
through Section 9.4.4. If you want to run all the test phases, skip the 
next section. 
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9.4.1 Running a Subset of Phases 


You can run a single phase by entering SUBSET or S in response to the 
following prompt: 


Run "ALL" UETP phases or a "SUBSET" [ALL] ? 
UETP prompts you for the phase you want to run as follows: 


You can choose one or more of the following phases: 
DEVICE, LOAD, DECNET, CLUSTER 


Phases (s): 


There is no default; enter one or more phase names from the list. Separate 
two or more phases with spaces or commas. 


If your choice includes the LOAD phase, UETP displays the three prompts 
described in the next sections. To run the LOAD phase, refer to the next 
section. 


If you exclude the LOAD phase, UETP responds with only two prompts: 


How many passes of UETP do you wish to run [1]? 
Do you want Long or Short report format [Long]? 


Section 9.4.2 and Section 9.4.4 discuss these questions. After you answer 
both questions, the phase you have selected runs to completion. 


9.4.2 Single Run Versus Multiple Passes 


If you specified the default ALL or a subset of phases at the last prompt, 
UETP displays the following message: 


How many passes of UETP do you wish to run [1]? 


You can repeat the test run as many times as you want. If you 

enter 1 in response to the prompt (or press RETURN for the default), 
UETP stops after completing a single run. If you specify a number greater 
than 1, UETP restarts itself until it completes the number of passes (runs) 
specified. 


You can run UETP once to check that the system is working, or many 
times to evaluate the system’s response to continuous use. For example, 

a field service technician who is interested only in verifying that a newly- 
installed system works might run UETP once or twice. A manufacturing 
technician might let the system run for several hours as part of the system 
integration and test. 


When you specify multiple UETP runs, you might want to request a short 
console log (see Section 9.4.4). Make certain that all line printers and 
hardcopy terminals have enough paper, because each run requires two 
pages. 
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9.4.3 Defining User Load for Load Test 


Note: 


After you specify the number of passes, UETP prompts you as follows: 


How many simulated user loads do you want [n]? 


UETP displays this prompt only if you choose to run the LOAD 
phase, either implicitly (by running all phases), or explicitly (by 
running a subset and specifying the LOAD phase). 


The load test simulates a situation in which a number of users (detached 
processes) are competing for system resources. In response to this prompt, 
enter the number of users you want to simulate for this test. The number 
in brackets is the default value that UETP computed for your system. 
The default value depends on the amount of memory and the paging and 
swapping space that your system has. 


Although the given default value is the best choice, you can increase or 
decrease the user load by entering your own response to the prompt. 
However, be aware that an increase might cause the test to fail because of 
insufficient resources. 


If you want to see UETP display the user load equation as it runs, see 
Section 9.5.2. 


9.4.4 Long and Short Report Format 
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The following prompt allows you to choose one of two console report 
formats: 


Do you want Long or Short report format [Long]? 


If you choose the long report format (the default), UETP sends all error 
messages as well as information on the beginning and end of all phases 
and tests to the console terminal. UETP records all its output in the 
UETP.LOG file, regardless of your response to this question. 


In many cases, it may not be convenient to have UETP write the bulk of 
its output to the terminal. For example, if you run UETP from a hardcopy 
terminal, the output printing can slow the progress of the tests. This delay 
may not be a problem if you have requested only one run; however, you 
may prefer to use the short format if you intend to run multiple passes of 
UETP from a hardcopy terminal. 


If you request the short format, UETP displays status information at the 
console, such as error messages and notifications of the beginning and 
end of each phase. This information enables you to determine whether 
UETP is proceeding normally. If the short console log indicates a problem, 
you can look at UETP.LOG for further information. UETP.LOG contains 
all the output generated by the various phases, as well as the status 
information displayed at the console. 


After you choose the report format, UETP initiates its sequence of tests 
and runs to completion. If UETP does not complete successfully, refer to 
Section 9.5 for troubleshooting information. 
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9.4.5 Termination of VETP 


9.4.5.1 


At the end of a UETP pass, the master command procedure UETP.COM 
displays the time at which the pass ended. In addition, UETP.COM 
determines whether UETP needs to be restarted. (You can request 
multiple passes when you start up the test package; see Section 9.4.2.) 


At the end of an entire UETP run, UETP.COM deletes temporary files and 
does other cleanup activities. 


Pressing CTRL/Y or CTRL/C lets you terminate a UETP run before it 
completes normally. Normal completion of a UETP run, however, includes 
the deletion of miscellaneous files that have been created by UETP for 
the purpose of testing. The use of CTRL/Y or CTRL/C might interrupt or 
prevent these cleanup procedures. 


The effect of these control characters depends on what part of UETP you 
are executing. For an explanation of the organization of UETP and its 
components, refer to Section 9.6. 


Using CTRL/Y 
Press CTRL/Y to abort a UETP run. Note, however, that cleanup of files 
and network processes in the [SYSTEST] directory may not be complete. 


If you are running an individual test image, pressing CTRL/Y interrupts 
the current UETP test and temporarily returns control to the command 
interpreter. While the test is interrupted, you can enter a subset of DCL 
commands that are executed within the command interpreter and do not 
cause the current image to exit. The VMS DCL Concepts Manual contains 
a table of commands that you can use within the command interpreter. In 
addition, you can enter any of the following commands: 


e The CONTINUE command continues the test from the point of 
interruption (except during execution of the cluster test). 


¢ The STOP command terminates the test; the test aborts and control 
returns to the command interpreter. 


Note: Using the STOP command may prevent cleanup procedures 


from executing normally. You should use the EXIT command 
if you want the image to do cleanup procedures before 
terminating. 


¢ The EXIT command does cleanup procedures and terminates the test 
(except during execution of the cluster test); control returns to the 
command interpreter. 


If you enter any DCL command other than CONTINUE, STOP and EXIT, 
the test does cleanup procedures and terminates, and the DCL command 
executes. 
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9.4.5.2 Using CTRL/C | 
Press CTRL/C to interrupt a UETP run. You cannot continue the same 
test phase after you press CTRL/C. UETP automatically goes to the next 
phase in the master command procedure. 


Some UETP phases react to CTRL/C by cleaning up all activity and 
terminating immediately. Such tests display the following message: 


SUETP-I-ABORTC, ‘testname’ to abort this test, type “C 


The phases that do not display the previous message terminate all 
processes they have started. These processes might not have a chance 
to complete normal cleanup procedures. 


If you are running an individual test image, however, you can use CTRL/C 
to terminate the execution of the image and complete cleanup procedures. 


Note that CTRL/C does not complete cleanup procedures for the cluster 
test. 





9.5 Troubleshooting 


This section explains the role of UETP in interpreting operational errors 
in a VMS operating system. Section 9.5.4 discusses common errors that 
can appear in a UETP run and describes how to correct them. 


9.5.1. Relationship of UETP to Error Logging and Diagnostics 


When UETP encounters an error, it reacts like a user program. It either 
returns an error message and continues, or it reports a fatal error and 
terminates the image or phase. In either case, UETP assumes the 
hardware is operating properly and it does not attempt to diagnose the 
error. 


If the cause of an error is not readily apparent, use the following methods 
to diagnose the error: 


¢ VMS Error Log Utility—Run the Error Log Utility to obtain a detailed 
report of hardware and system errors. Error log reports provide 
information about the state of the hardware device and I/O request at 
the time of each error. For information about running the Error Log 
Utility, refer to the VMS Error Log Utility Manual. 


¢ Diagnostic facilities—Use the diagnostic facilities to test exhaustively 
a device or medium to isolate the source of the error. 


9.5.2 Interpreting UETP Output 


You can monitor the progress of UETP tests at the terminal from which 
they were started. This terminal always displays status information, such 
as messages that announce the beginning and end of each phase and 
messages that signal an error. 
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The tests send other types of output to various log files, depending on how 
you started the tests. The log files contain output generated by the actual 
test procedures. Even if UETP completes successfully, with no errors 
displayed at the terminal, it is good practice to check these log files for 
errors. Furthermore, when errors are displayed at the terminal, check the 
log files for more information about their origin and nature. 


Each test returns a final completion status to the test controller image, 
UETPHAS00, using a termination mailbox. This completion status 

is an unsigned longword integer denoting a condition value. As a 
troubleshooting aid, UETPHAS00 displays the test’s final completion 
status using the $FAO and $GETMSG system services. Sometimes, 
however, the $FAO service needs additional information which cannot 
be provided using the termination mailbox. When this happens, UETP 
displays an error message similar to the following: 


UETP-E-ABORT, !AS aborted at !%D 


When UETP displays these types of error messages, check the log files 
for more information. You can also run the individual test to attempt to 
diagnose the problem. 


The error messages that appear at the terminal and within the log files 
have two basic sources: 


¢ UETP tests 


¢ System components that are tested — 


To interpret the messages, you might need to refer either to the VMS 
System Messages and Recovery Procedures Reference Volume or to the 
manual that describes the individual system component. 


Several parts of UETP, such as some device tests, UETINITO0. EXE, 
UETCLIG00.EXE, and UETDNETO00.COM, let you obtain additional 
information concerning the progress of the test run or the problems it 
encounters. Because this information is usually insignificant, it is not 
displayed on the screen. To view the information, enter the following 
command and run the program: 


$ DEFINE MODE DUMP 


The following example shows the output for UETINITO0O.EXE on a 
VAX 11/750: 


$ RUN UETINITOO 
Welcome to VAX/VMS UETP Version V5.3 
SUETP-I-ABORTC, UETINITOO to abort this test, type *C 


You are running on ‘an 11/750 CPU with 8704 pages of memory. 
The system was booted from _DRA0:[SYS0.]. 
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Run "ALL" UETP phases or a "SUBSET" [ALL]? 
How many passes of UETP do you wish to run [1]? 


The default number of loads is the minimum result of 


1) CPU_SCALE * ((MEM FREE + MEM MODIFY) / (WS_SIZE * PER_WS_INUSE)) 
0.80 * (( 8704 + 323) 4, 350. 0.20)) = 103 


56 


2) Free process slots 


3) Free page file pages / Typical use of page file pages per process 
18040 / 1000 = 18 


How many simulated user loads do you want [18]? 
Do you want Long or Short report format [Long]? 


UETP starting at 19-APR-1990 09:08:26.71 with parameters: 

DEVICE LOAD DECNET CLUSTER phases, 1 pass, 18 loads, long report. 

$ 

This program does not initiate any phase; it displays the equation used by 
UETP to determine user load and the specific factors that are employed in 
the current run. 


You should respond to the questions by pressing RETURN. After you 
respond to the first prompt, the program displays the expressions that 
determine the default number of simultaneous processes. The following 
definitions apply: 


¢ CPU_SCALE refers to the relative processing power of the CPU in 
relation to a VAX-11/780. For example, a VAX—11/785 has a 
CPU_SCALE of 1.5 because it has 1.5 times the processing power of a 
VAX-—11/780 (1.0). 


¢ MEM_FREE represents memory in pages available to users. 
¢ MEM_MODIFY represents memory pages on the modified page list. 
¢ WS_SIZE represents working set size. 


¢ PER_WS_INUSE represents typical percentage of the working set in 
active use for each process. 


UETINIT00 also displays the specific values represented by the 
expressions. In this example, UETP selects 18 as the default for simulated 
user loads, because 18 is the minimum result of the three expressions. 


You should deassign the logical name MODE before running UETP, unless 
you prefer to see the previous breakdown every time you run UETP. 


Defining a Remote Node for UETP Ethernet Testing 

Occasionally during the UETUNAS00 test, it is difficult to determine 
whether the problem reports concern the device under test or the remote 
device. The easiest way to ensure proper error reporting is to define a 
“good turnaround.” A “good turnaround” is a remote node that you know 
turns around Ethernet packets correctly and is up and waiting in the 
ready state. 


You can make the UETUNAS00 test use a known “good turnaround” by 
performing the following actions. In the commands that follow, assume 
that the “good” device is on node BETA, and that node BETA is already 
defined in the network database. | 
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Find the address of the “good” Ethernet node by using the Network 
Control Program (NCP). In order to use NCP, the following conditions 
must apply: 


¢ DECnet—VAX must be up and running on the system. 


¢ The account you are using must have TMPMBX and NETMBX 
privileges. 
Enter the following commands and press RETURN: 


S$ RUN SYSSSYSTEM:NCP 
NCP> TELL BETA SHOW CHARACTERISTICS ACTIVE LINES 


If node BETA has not been defined in your network database, NCP 
displays an error message. In this event, specify another “good” node 
and retry the command. Otherwise, see your system or network 
manager. 


NCP displays information similar to the following: 


Active Line Volatile Characteristics as of 19-APR-1990 16:13:02 
Line = UNA-0O 


Counter timer = 28800 

Receive buffers = 6 

Controller = normal 

Protocol = Ethernet 

Service timer = 4000 

Hardware address = AA-00-04-00-46-D3 
UNA device buffer size = 1498 


2 


The Log Files 


Use the displayed hardware address (in this case, AA00040046D3) to 
define the logical name TESTNIADR to point to the “good turnaround.” 
Note that you do not specify the hyphens (-). 


First, log in to the SYSTEST account. Then enter the following 
command: 


$ DEPINE/SYSTEM TESTNIADR AA00040046D3 
Run UETP. 


When UETP has completed, deassign the logical name TESTNIADR 
by entering the following command: 


$ DEASSIGN/SYSTEM TESTNIADR 


At the end of a UETP run, the directory SYS$TEST contains a log file 
named UETP.LOG. This file contains all information generated by all 
UETP tests and phases. If the run involves multiple passes, you will find 
a version of UETP.LOG for each pass. 


Although UETP.LOG contains information from all the passes, only 
information from the latest run is stored in this file. Information from 


the 


previous run is stored in a file named OLDUETP.LOG, which also has 


a version for each pass. Using these two files, UETP provides the output 
from its tests and phases from the two most recent runs. 
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The cluster test creates a NETSERVER.LOG file in SYS$TEST for 
each pass on each system included in the run. If the test is unable to 
report errors (for example, if the connection to another node is lost), the 
NETSERVER.LOG file on that node contains the result of the test run 
on that node. UETP does not purge or delete NETSERVER.LOG files; 
therefore, you must delete them occasionally to recover disk space. 


If a UETP run does not complete normally, SYS$TEST might contain 
other log files. Ordinarily these log files are concatenated and placed 
within UETP.LOG. You can use any log files that appear on the system 
disk for error checking, but you must delete these log files before you run 
any new tests. You may delete these log files yourself or rerun the entire 
UVETP, which checks for old UETP.LOG files and deletes them. 


Possible UETP Errors 


This section is intended to help you identify and solve problems you might 
encounter running UETP. You should refer to this section if you need help 
understanding a system failure and isolating its cause. This section is not 
intended as a repair manual and is not expected to diagnose any flaws in 
your system. It should, however, help you to interpret and act upon the 
information in the error messages. 


If you are unable to correct an error after following the steps in this 
section, you should contact your Digital Customer Service representative. 
Any information you can supply about the measures you have taken to 
isolate the problem will help your Digital Customer Service representative 
diagnose the problem. 


The following are the most common failures encountered while running 
UETP: 


Wrong quotas, privileges, or account 
UETINITO1 failure 

Insufficient disk space 

Incorrect VAXcluster setup 
Problems during the load test 
DECnet—VAX error 

Errors logged but not displayed 

No PCB or swap slots 

Hangs 

10 Bugchecks and machine checks 


oontsodg A © NY = 


The following sections describe these errors and offer the best course of 
action for dealing with each one. 
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9.5.4.1 Wrong Quotas, Privileges, or Account 
If your assigned quotas or privileges do not match standard quotas and 


privileges for the SYSTEST account, UETP displays the following error 


message: 
KKKKKKKKKKKKKKKKKRKRKR KKK 
* UETINITOO * 
* Error count = J] * 


KKK KKK KKK KK KER KKK RE KKK 
~UETP-W-TEXT, The following: 


OPER privilege, 
BIOLM quota, 
ENQIM quota, 
FILLM quota, 


are nonstandard for the SYSTEST account and may result in UETP errors. 


This message informs you that the OPER privilege and the BIOLM, 
ENQLM, and FILLM quotas either are not assigned correctly or are not 
assigned at all. 


Note: UETP displays a similar message if you run the cluster integration 
test phase, and the privileges and quotas for the SYSTEST_CLIG 
account are incorrect. The SYSTEST and SYSTEST_CLIG accounts 
require the same privileges and quotas. Take the same action 


described in this section. 


Solution 
To correct the problem, use the following procedure: 


1 Display all privileges and quotas in effect for the current account 
using the DCL commands SHOW PROCESS/PRIVILEGE and SHOW 
PROCESS/QUOTA as follows: 


$ SHOW PROCESS/PRIVILEGES 


L9-APR-1990 18:06:02.89 OPAO: User : SYSTEST 
Process privileges : 
CMKRNL May change mode to kernel 
CMEXEC IMay change mode to exec 
SYSNAM may insert in system logical name table 
GRPNAM may insert in group logical name table 
DETACH May create detached processes 
DIAGNOSE may diagnose devices 
LOG_IO may do logical I/0 
GROUP may affect other processes in same group 
PRMCEB may create permanent common event clusters 
PRMMBX may create permanent mailbox 
SETPRV may set any privilege bit 
TMPMBX may create temporary mailbox 
NETMBX may create network device 
VOLPRO may override volume protection 
PHY_I0O may do physical I/0 
SYSPRV may access objects via system protection 


$ SHOW PROCESS/QUOTAS 


19=APR-1990 18:06:03.36 OPAO: User: SYSTEST 
Process Quotas: 
Account name: SYSTEST 
CPU limit: Infinite Direct I/O limit: 55 


Buffered I/O byte count quota: 


32768 Buffered I/O limit: 18 
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Timer queue entry quota: 20 Open file quota: 100 
Paging file quota: 19543 Subprocess quota: 8 
Default page fault cluster: 64 AST limit: 98 
Enqueue quota: 300 Shared file limit: 0 
Max detached processes: 0 Max active jobs: 0 


2 Check that the privileges and quotas assigned to the account match 
the following: 


Privileges 


CMKRNL CMEXEC NETMBX DIAGNOSE 
DETACH PRMCEB PRMMBX PHY_IO 
GRPNAM TMPMBX VOLPRO LOG_IO 
SYSNAM SYSPRV SETPRV GROUP 


Quotas 

BIOLM: 18 PRCLM: 8 

DIOLM: 55 ASTLM: 100 

FILLM: 100 BYTLM: 32768 
TQELM: 20 CPU: no limit 
ENQLM: 300 PGFLQUOTA: 20480 
WSDEFAULT: 256 WSQUOTA: 512 


WSEXTENT: 2048 


3 If any privileges or quotas are incorrect, run the Authorize Utility 
(AUTHORIZE) to add them (AUTHORIZE is explained in the VMS 
Authorize Utility Manual). As an alternative, you can temporarily 
assign the correct privileges with the DCL command SET 
PROCESS/PRIVILEGES. 


If you are logged in to the wrong account, the following error message asks 
you to log in to the SYSTEST account: 


$ QUETP 


KKKKKREKEKEKKKEKKRREKRKKEKKKEKE 


* UETINITOO * 


* Error count = 1 * 
KKEKEKEKKEKKEKRKRKKKKRRKKKKEESE 


~UETP-E-ABORT, UETINITOO aborted at 19-APR-1990 14:24:10.13 
-UETP-E-TEXT, You are logged in to the wrong account. 

Please log in to the SYSTEST account. 
$ 


You must run UETP from the SYSTEST account. 
UETINITO1 Failure 


UETINITO1 failures are related to peripheral devices; this type of error 
message might indicate any of the following: 


¢ Device failure 
¢ Device not supported or not mounted 


e Device allocated to another user 
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¢ Device write-locked 
¢ Lost vacuum on a magnetic tape drive 


¢ Drive off line 


In some cases, the course of action you should take is specified explicitly 
in the error message. For example, you might receive a message from the 
Operator Communication Facility (OPCOM) process informing you of a 
problem and recommending a corrective measure: 


%OPCOM, 19-APR-1990 14:10:52.96, request 1, from user SYSTEST 
Please mount volume UETP in device MTAO: 
SMOUNT-I-OPRQST, Please mount volume UETP in device MTAO: 


Other error messages might relate information in which the solution is 
specified implicitly: 


%$UETP-S-BEGIN, UETDISKOO beginning at 19-APR-1990 13:34:46.03 


KREKKEKKEKKRKEKKEKKKKKKKKKK 
* DISK_DRA x 


* Error count = 1 * 
KKEEKKKRKKKKRKRKR RRR 


-UETP~E-TEXT, RMS file error in file DRAO:DRAOO.TST 
-RMS-E-DNR, device not ready or not mounted 
SUETP-S-ENDED, UETDISKO0O ended at 19-APR-1990 13:34:46.80 


This message tells you that a disk drive is either not ready or not 
mounted. From this information, you know where to look for the cause of 
the failure—at the disk drive. If you cannot see the cause of the problem 
immediately, check the setup instructions in Section 9.3. 


In other cases, the cause of a failure might not be obvious from the 
information in the message. The problem might be related to hardware 
rather than software. For example, the Ethernet adapter test may produce 
one of the following messages if UETP does not have exclusive access to 
the Ethernet adapter: 


e Inter-module cable unplugged 
e §6Self-test failure code 0000000 


To run the self-test diagnostic on the Ethernet adapter successfully, VETP 
needs exclusive access to the adapter. Because either DECnet—VAX or 
the LAT terminal server might also want to use the Ethernet adapter (a 
shareable device), UETP requires that you shut down DECnet—VAX and 
the LAT terminal server before you run the device test phase. 


Solution 


To determine where or when the failure occurs in the execution of UETP, 
use the following procedure: 


e Run the device test individually (see Section 9.4.1). By doing this, you 
can determine if the failure can be re-created. Also, you are isolating 
the cause of the problem by reproducing it using the least amount of 
software possible. For example, if the failure occurs only when you 
run the entire device phase, and not when you run the affected device 
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test individually, you can conclude the problem is related to device- 
interaction. Conversely, if you can re-create the error by running the 
single device test, then you have proved that the error is not related to 
device interaction. 


¢ Run the device test with different media. If your run of the single 
device test succeeded in reproducing the error, the magnetic tape or 
disk media could be defective. Running the same test with new media 
determines whether this is the problem. 


e Call Digital Customer Service. If you have tried all the previous steps 
without solving the problem, you should contact your Digital Customer 
Service representative. 


Insufficient Disk Space 

When you run continuous passes of UETP, log files accumulate on the 
disk from which UETP was run. These files reduce the amount of free 
disk space available for each successive pass. If the amount of disk space 
available becomes too small for the current load, the following error 
message appears: 


SUETP-S-BEGIN, UETDISKOO beginning at 19-APR-1990 08:12:24.34 
SUETP-~I-ABORTC, DISK_DJA to abort this test, type “C 


KKKEKKKEKKKEKKKEKKKKRKKKKKK 


* DISK DJA * 


* Brror count = 1 * 
KKKKKKKKKKKKRKKKRKKRKRKRKKEK 


-UETP-F-TEXT, RMS file error in file DJAO:DJA00O.TST 
~RMS-F-FUL, device full (insufficient space for allocation) 


KRHEKKKKKRKKKKKEKEKKKKKKKKE 


* DISK DJA * 


* Error count = 2 * 
KKK KKKRKRKR KKK KKK KKK 


-UETP-F-TEXT, RMS file error in file DJAOQ:DJA01.TST 

-RMS-F-FUL, device full (insufficient space for allocation) 
SUETP-E-DESTP, DISK_DJA stopped testing DJA unit 0 at 08:12:36.91 
SUETP-S-ENDED, UETDISKOO ended at 19-APR-1990 08:12:37.98 


Solution 


Make more space available on the disk. You can do this by using one or 
more of the following techniques: 


¢ Delete unnecessary files to create more space. 
¢ Purge files, if multiple versions exist. 
¢ Mount a volume with sufficient space. 


¢ Check for disk quotas that may be enabled on the disk. If disk quotas 
are enabled, either disable or increase them (see the VMS SYSMAN 
Utility Manual for a description of the Disk Quota Utility). 


¢ Run VMSTAILOR if you have a small-disk system. See Chapter 3 for 
more information. 


See Section 9.2.1 and Section 9.3.2 for a further discussion of disk space. 
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9.5.4.4 Incorrect Setup of a VAXcluster 
Most problems that can occur during the cluster-integration test are 
related to improper setup of the VAXcluster or of UETP on the VAXcluster. 
These problems are most likely to occur at the following stages of the 
VAXcluster test: 


e Near the beginning, when processes on VMS nodes are started 


¢ Toward the end, when cluster file access is checked 


The cluster test phase shows that various VMS nodes in your cluster can 
simultaneously access files on selected nodes in the cluster. First, UETP 
tries to create a file on a disk drive that is accessible to the other selected 
nodes in the cluster. The following are the requirements for creating a file 
in the cluster test phase: 


¢ There must be a [SYSTEST] directory on the disk in either the master 
file directory (MFD).or in the root directory [SYS0.]. 


¢ The [SYSTEST] directory must be protected so that the SYSTEST 
account can create a file in it. 


If UETP is unable to find a suitable device on a certain node, the test 
displays a warning message and proceeds to the next cluster node. 


Nodes on which the operator’s terminal (OPAQ) is set to the “No broadcast” 
terminal characteristic will generate the following error message during 
the cluster test: 


KRREKKKEKKKEKKKEKKKKKKRKKKK 


* UETCLIGOOmaster * 


x Error count = 1 * 
KKEKEKKKKKKKEKKKKRKRKKRRKEK 


-UETP-E-TEXT, 0 operator consoles timed out on the cluster test warning 
and 1 operator console rejected it. 

-UETP-E-TEXT, Status returned was, 
"SSYSTEM-F-DEVOFFLINE, device is not in configuration or not 
available" 


Disregard this message if OPAO is set to “No broadcast.” 


Solution 


Whenever you suspect a problem, you should try to recover the 
SYS$TEST:NETSERVER.LOG file that was created when the SYSTEST_ 
CLIG process was created. This file may contain additional error 
information that could not be transmitted to the node running the test. If 
it was not possible to create the SYSTEST_CLIG process on some node, 
the system accounting file for that node may contain a final process status 
in a process termination record. 


The following problems can occur during a cluster test: 


e Logging in at other nodes—This problem is due to incorrect setup for 
the cluster test at the remote VMS node. For example, if you specified 
a password for the SYSTEST_CLIG account or if you disabled the 
SYSTEST_CLIG account, the test displays the following message: 


%SYSTEM-F-INVLOGIN, login information invalid at remote node 
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Refer to Section 9.3.13 and Section 9.5.2.1 for information on preparing 
for VAXcluster testing. | 


¢ Communicating with other nodes—A message indicates a DECnet— 
VAX problem. Check the NETSERVER. LOG file on the affected node 
to determine the cause. 


¢ Taking out locks or detecting deadlocks—The most likely cause of 
this problem is that you are not logged in to the SYSTEST account. 
Another possibility is that your cluster is not configured properly. 


e Creating files on VAXcluster nodes—This problem is due to incorrect 
setup for the cluster test; refer to Section 9.3.13 for information on 
preparing for VAXcluster testing. 


9.5.4.5 Problems During the Load Test 


A variety of errors can occur during the load test because the command 
procedures that are started during the tests run several utilities and do 
many functions. Tracking a problem can be difficult because UETP deletes 
the log files that are generated during the load test (see Section 9.6.3). 


| Solution 


Ifa problem occurs during the load test and the cause is not obvious, you 
can modify UETP.COM to preserve the log files as follows: 


1 Add the /NODELETE qualifier to the following line: 
$ TCNTRL UETLOADOO.DAT/PARALLEL COUNT=’ LOADS/REPORT TYPE=’ REPORT 
2 Delete the following line: 


$ DELETE UETLO*.LOG; * 


Rerun the load test with these changes to try to re-create the problem. 


If you re-create the problem, look at the contents of the appropriate log 
file. You can determine which log file to read by understanding the scheme 
by which the load test names its processes and log files. (The log file 
names are derived from the process names.) 


The load test creates processes that are named in the following format: 
UETLOADnn_nnnn 
For example: 


%SUETP-I-BEGIN, UETLOADOO beginning at 19-APR-1990 15:45:08.97 
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SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP—-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-~BEGIN, 
SUETP-I-BEGIN, 
SUETP-I-BEGIN, 


UETLOAD02_ 0000 
UETLOADO3 0001 
UETLOAD04 0002 
UETLOAD05 0003 
UETLOAD06 0004 
UETLOADO7_0005 
UETLOADO8 0006 
UETLOADO9 0007 
UETLOAD10_0008 
UETLOAD11_0009 
UETLOADO2_ 0010 
UETLOAD03 0011 
UETLOAD04 0012 


beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 
beginning 


at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 
at 


19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
19-APR~-1990 
19-APR-1990 
19-APR-1990 
19-APR-1990 
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Note that if more than 10 processes are created, the numbering 
sequence for the UETLOADnn portion of the process name starts over 
at UETLOAD02; however, the 4 digits of the _nnnn portion continue to 
increase. 


Each load test process creates two log files. The first log file is created by 
the test controller; the second log file is created by the process itself. The 
log file that you need to look at for error information on any given load 
test process is the one that was created by the test controller (the first log 
file). 


The load test log file derives its file name from the process name, 
appending the last four digits of the process name (from the _nnnn 
portion) to UETLO. The test-controller log file and the process log file 
for each process use the same file name; however, the process log file has 
the higher version number of the two. For example, the log files created 
by the process UETLOAD05_0003 would be named as follows: 


UETLO0003.LOG;1 (test-controller log file) 
UETLO0003.LOG;2 (process log file) 


Make sure that you look at the log file with the lower version number; 
that file contains the load test commands and error information. 


After you have isolated the problem, restore UETP.COM to its original 
state and delete the log files from the load test (UETLO*.LOG;*); failure 
to delete these files might result in disk space problems. 


DECnet-VAX Error 
A DECnet—VAX error message might indicate that the network is 
unavailable. 


Solution 


e If DECnet—VAX is included in your system, register the authorization 
key (see the VMS Release Notes). 


e If DECnet—VAX is not included in your system, ignore the message; it 
is normal and does not affect the UETP run. 


If you encounter other DECnet—VAX-related errors, you should do the 
following: 


¢ Run DECnet—VAX as a single phase (see Section 9.4.1) to determine 
whether the error can be re-created. | 


e Refer to the VMS System Messages and Recovery Procedures Reference 
Volume. 


Errors Logged but Not Displayed 

If no errors are displayed at the console terminal or reported in the 
UETP.LOG file, you should run the Error Log Utility to see if any errors 
were logged in the ERRLOG.SYS file. See the VMS Error Log Utility 
Manual for information about running the Error Log Utility. 
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9.5.4.8 No PCB or Swap Slots 


The following error message indicates that no process control block (PCB) 


or swap slots are available: 


SUETP-I-BEGIN, UETLOADOO beginning at 19-APR-1990 07:47:16 

SUETP-I-BEGIN, UETLOADO2 0000 beginning at 19-APR-1990 07: 

SUETP-I-BEGIN, UETLOADO3 0001 beginning at 19-APR-1990 07: 

SUETP-I~BEGIN, UETLOAD04 0002 beginning at 19-APR-1990 07: 

SUETP-I-BEGIN, UETLOADO5 0003 beginning at 19-APR-1990 07: 

SUETP-I-BEGIN, UETLOADO6 0004 beginning at 19-APR-1990 07: 

SUETP-W-TEXT, The process -UETLOAD07_0005- was unable to be 
the error message is 

~SYSTEM-F-NOSLOT, no pcb or swap slot available 

SUETP-W-TEXT, The process -UETLOAD08 0006- was unable to be 
the error message is 

-SYSTEM-F-NOSLOT, no pcb or swap slot available 

SUETP-W-TEXT, The process -UETLOAD09 0007- was unable to be 
the error message is : 

-SYSTEM-F-NOSLOT, no pcb or swap slot available 

SUETP-W-TEXT, The process -UETLOAD10 0008- was unable to be 
the error message is 

-SYSTEM-F-NOSLOT, no pcb or swap slot available 

SUETP-W-TEXT, The process -UETLOAD11 0009- was unable to be 
the error message is 

-SYSTEM-F-NOSLOT, no pcb or swap slot available 

SUETP-W-ABORT, UETLOADOO aborted at 19-APR-1990 07:47:54.1 


-UETP-W-TEXT, Aborted via a user CTRL/C. 
KKKEKKEKKKKKKEKKKKEKKKEKEKKKKEKKEKEKREKRKKEKKKEKKKKKEKKEKKEKKKKK 


* * 
END OF UETP PASS 1 AT 19-APR-1990 07:48:03.17 

* * 

KRRKEKKKKKKRKEKRKEKKKERKEKKKRKEEKRRKEKEKRRRKKKREKERKKRRERKEKEKKKEKKE 


Solution 


-50 
47:16.76 
47:16.92 
47:17.13 
47:17.35 
47:17.61 
created, 


created, 


created, 


created, 


created, 


0 


To solve this problem, use the following procedure: 


1 Rerun individually the phase that caused the error message (the 
LOAD phase in the previous example) to see if the error can be 


reproduced. 


2 Increase the size of the page file, using either the command procedure 
SYS$SUPDATE:SWAPFILES.COM or the System Generation Utility 


(see the VMS System Generation Utility 


3 Increase the SYSGEN parameter MAXPROCESSCNT, if necessary, 


and reboot the system. 


4 Increase both the page file size and the MAXPROCESSCNT, if 


necessary. 





9.5.4.9 Hangs 


If there is no keyboard response or system disk activity, the system may 


be hung. 
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Solution 


A system hang can be difficult to trace; you should always save the dump 
file for reference. To learn why the system hung, run the System Dump 
Analyzer as described in the VMS System Dump Analyzer Utility Manual. 
Reasons for a system hang include the following: 


¢ Insufficient pool space—Reboot the system with a larger value for 
NPAGEVIR. 


e Insufficient page file space—Increase the page file space using the 
System Generation Utility as described in the VMS System Generation 
Utility Manual. 


e I/O device failure causing driver-permanent loop—Call Digital 
Customer Service. 


9.5.4.10 Bugchecks and Machine Checks 
When the system aborts its run, a bugcheck message appears at the 
console. 
Solution 


Call Digital Customer Service. Often a hardware problem causes 
bugchecks and machine checks; there is no easy way to solve bugchecks 
or machine checks. It is important, however, that you save the 
SYS$SYSTEM:SYSDUMP.DMP and ERRLOG.SYS files so that they 
are available for examination. It is also important to know whether the 
failure can be re-created; you can verify this by running UETP again. 


9.6 UETP Tests and Phases 


This section explains in detail the organization of UETP and the individual 
components within the test package. 


You run UETP by starting a master command procedure containing 
commands to start each test phase. The procedure begins by prompting 
you for information needed by the various test phases. (See Section 9.4 for 
a detailed description of starting UETP.) 


The master command procedure, UETP.COM, contains commands that 
initiate each test phase. UETP.COM also contains commands that do such 
tasks as defining logical names and manipulating files generated by the 
tests. 


The UETP.COM procedure also issues commands to start the test 
controlling program, UETPHAS00.EXE, which, in turn, controls each 
test phase. The test controller starts up multiple detached processes. It 
also reports their completion status and other information the processes 
report to it. | 


The following sections describe the various UETP test phases. 
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9.6.1 Initialization Phase 
The following occurs during the initialization phase: 


e The image UETINITO0.EXE prompts you for information (see 
Section 9.4). Your information defines variables that affect the 
execution of UETP tests. 


e The image UETINITO1.EXE gathers information on all the controllers 
in the system and on their associated devices. This image writes the 
information into a file called UETINIDEV.DAT. 


e Using the information in UETSUPDEV.DAT, UETINITO1.EXE 
verifies which devices in the system are operable by running the 
appropriate device test. Each device test completes a simple read/write 
operation to each device. If a device fails this test, the device’s entry 
in UETINIDEV.DAT specifies that the device cannot be tested. As a 
result, subsequent UETP tests ignore that device. 


e For each testable controller, UETINITO1.EXE writes a line into a 
file called UETCONTO00.DAT. The line associates a test file with the 
controller it tests. 


A summary of UETINIDEV.DAT always exists in UETP.LOG, and 
UETINITO1.EXE sends that summary to the console if you have requested 
the long report format. 


9.6.2 Device Test Phase 


The device test phase includes separate tests for each type of device, such 
as disk, magnetic tape, line printer, and terminal. This section explains 
the device test phase and presents instructions for testing a single device. 
If you want to run the entire device test phase individually, refer to 


Section 9.4.1. 
9.6.2.1 How the Device Phase Works 


The UETP device test phase starts an executable image, the phase 
controller UETPHAS00, which creates a detached process for every device 
controller to be tested. For example, if a system includes three terminal 
controllers, one line printer controller, and two disk controllers, the image 
creates six detached processes. In parallel, the detached processes execute 
images that test the various types of devices. 


The initialization phase of UETP creates a file called UETINIDEV.DAT 
and a file called UETCONT00.DAT. UETINIDEV.DAT contains data on 
the VMS-supported controllers in the system and their associated devices; 
UETCONT00.DAT associates a device test image with each testable 
controller. 


UETPHAS00 uses the information in UETCONTO00.DAT to find a 
device controller name to pass to each detached process that it creates. 
UETPHAS00 passes the controller name by writing it to a mailbox that 
is SYS$INPUT to individual tests. Each detached process uses that 
data to determine which controller to test. The test image then searches 
UETINIDEV.DAT for the device controller and for all testable units on 
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that controller. The phase controller terminates when all devices on all 
controllers have completed testing. 


Because UETCONT00.DAT is deleted automatically at the end of a UETP 
run, you cannot run the device phase unless you start UETP.COM; you can 
run only individual test images. UETINIDEV.DAT exists in SYS$TEST 
unless you explicitly delete it. 


Running a Single Device Test 

You must be logged in to the SYSTEST account to run the individual tests 
as described in this section. Also, a copy of UETINIDEV.DAT must exist. 
If a copy of the file is not present from a previous run (a run of the entire 
UETP or a run of the device test phase creates UETINIDEV.DAT), you can 
create it. Note that when you run a single test, no log file is created; the 
test sends all its output to your terminal. 


If you do not want to test all the device types, you can test a specific 
controller by choosing a test image name from Table 9-1 and executing it 
as in the following example: 


$ RUN UETTTYSOO 
Controller designation?: TTB 


UETP prompts you for the controller designation and the device code. 
Unless you are testing your own terminal, you must explicitly designate 
a controller name. If you are running the terminal test, you can press 
RETURN to test your terminal only. 


If you plan to repeat the run several times, you might find it more 
convenient to define the logical name CTRLNAME as follows: 


S$ DEFINE CTRLNAME TTB 
$ RUN UETTTYSOO 


When you define the controller name in this way, the logical name 
CTRLNAME remains assigned after the test completes. To deassign 
this logical name, use the DCL command DEASSIGN as follows: 


$ DEASSIGN CTRLNAME 


Format of UETINIDEV.DAT 


The UETINIDEV.DAT file is an ASCII sequential file that you can type 
or edit if necessary. The contents of this file are shown in the following 
command sequence: 


S TYPE UETINIDEV.DAT 
DDB x ddd 


UCB y uuuuu 
END OF UETINIDEV.DAT 
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The symbols in this example are defined as follows: 


Symbol Value 


x T, if there are any testable units for this controller; N, if this controller is not 
to be tested 

y T, if this unit is testable; N, if this unit is not testable 

ddd device controller name, for example DUA 

uuUUUU device unit number, for example 25 


UETINIDEV.DAT contains a DDB (device data block) line for each 
controller connected or visible to your system. After the DDB line there is 
a UCB (unit control block) line for each unit connected to that controller. 
In addition, if your system uses MA780 memory in a loosely coupled CPU 
configuration, UETINIDEV.DAT includes one UCB line for each MA780 
memory. A device test can test a particular device only if both the DDB 
line and the UCB line indicate that the device is testable. 


Running a Test in Loop Mode 


If you want to put extra stress on a device, you can run the device test in 
loop mode, which causes the test to run indefinitely. For example: 

$ DEFINE MODE LOOP 

$ RUN UETDISKO00 


Controller designation?: DRA 
sSUETP-I-TEXT, End of pass 1 with 980 iterations at 19-APR-1990 16:18:51:03 


re 


You must use CTRL/C to terminate the test run. If you use CTRL/Y, UETP 
does not complete cleanup procedures. 


Functions of Individual Device Tests 


For each disk in the system, the disk test allocates two files into which it 
randomly writes blocks of data. The test then checks the data, reports any 
errors to SYSSOUTPUT, and deletes the disk files. 


When you run the disk test phase in a cluster environment, the test 
accesses all disks that are mounted by the system being tested, and 
users of the disk being tested might encounter an insufficient disk space 
problem. You should warn users on remote nodes (who share disks with 
users on the local system) that UETP may be testing a disk they are using. 


The magnetic tape test exercises all the magnetic tape drives in the 
system. The test creates a large file on each mounted magnetic tape, into 
which it writes multiple sequential records of varying sizes. After writing 
the records, the test rewinds the magnetic tape, validates the written 
records, and re-initializes the magnetic tape. 


The terminal and line printer test generates several pages or screens of 
output, in which each page or screen contains a header line and a test 
pattern of ASCII characters. A header line contains the test name, the 
device name, the date, and the time. 
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For the laboratory peripheral accelerator (LPA11—K), the test image 
determines the configuration on the LPA11—K’s I/O bus. The image loads 
all types of microcode to the LPA11—K and reads or writes data for each 
device on the LPA11-K J/O bus. 


The communications device tests fill the transmit message buffer with 
random data; then, using loopback mode, the tests transmit and receive 
the message several times. To check that the looped-back data is correct, 
an AST routine is associated with a $QIO read to compare the received 
message against the transmitted message. The procedure is repeated 
using messages of different lengths. 


The interface device tests put the devices they are testing in maintenance 
mode, write random data, and then verify the data. 


The MA780 device test creates and modifies mailboxes, common event 
flags, and global sections in shared memory; then it verifies that 
modifications can be made. You can run MA780 tests in parallel from 
separate systems so that the tests interact with each other through 
common MA780 memories. | 


The Ethernet adapter test does self-test diagnostics on the device. It also 
does read and write tasks with test data that uses various adapter modes 
(such as internal loopback and external loopback). 


Table 9-1 lists the device test images and the devices to be tested. 


Table 9-1 The Device Tests 


Test Image Name Devices Tested 

UETDISKO0.EXE Disks 

UETTAPE00.EXE Magnetic tape drives and tape cartridge drives 
UETTTYS00.EXE Terminals and line printers 

UETLPAKOO.EXE LPA1i—-K 


UETCOMS00.EXE ~ DMC11, DMR11 
UETDMPFO00.EXE DMF32, DMP 11 
UETDR1W00.EXE DR11-W 
UETDR7800.EXE DR780, DR750 
UETMA7800.EXE MA780 
UETUNASO0.EXE Ethernet Adapters 


9.6.3 System Load Test Phase 


The purpose of the system load test is to simulate a number of terminal 
users who are demanding system resources simultaneously. The system 
load tests, directed by the file UETLOADOO.DAT, create a number of 
detached processes that execute various command procedures. Each 
process simulates a user logged in at a terminal; the commands within 
each procedure are the same types of commands that a user enters 

from a terminal. The load test creates the detached processes in quick 
succession, and the processes generally execute their command procedures 
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simultaneously. The effect on the system is analogous to an equal number 
of users concurrently issuing commands from terminals. In this way, the 
load test creates an environment that is similar to normal system use. 


The load test uses the logical name LOADS to determine the number of 
detached processes to create. When you initiate the UETP command 
procedure, it prompts for the number of users to be simulated (see 
Section 9.4.3) and consequently the number of detached processes to 

be created. Your response, which depends on the amount of memory and 
the swapping and paging space in your system, defines the group logical 
name LOADS. 


The UETP master command procedure deassigns all group logical names 
assigned by its tests as part of the termination phase. The group logical 
name LOADS remains assigned only if the UETP package does not 
complete normally. 


The command procedures executed by the load test can generate a large 
amount of output, depending on the number of detached processes created. 
For each detached process (or user), the test creates a version of an 
output file called UETLOnnnn.LOG (“nnnn” represents a string of numeric 
characters). The console displays only status information as the load test 
progresses. 


Whether the load test runs as part of the entire UETP or as an individual 
phase, UETP combines the UETLOnnnn.LOG files, writes the output to 
the file UETP.LOG, and deletes the individual output files. 


You can run the system load test as a single phase by selecting LOAD 
from the choices offered in the startup dialog (see Section 9.4.1). 


9.6.4 DECnet—VAX Test Phase 
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If DECnet—VAX is included in your VMS system, a run of the entire 
UETP automatically tests DECnet—-VAX hardware and software. Because 
communications devices are allocated to DECnet—-VAX and the DECnet— 
VAX devices cannot be tested by the UETP device test, UETP will not test 
the Ethernet adapter if DECnet—VAX or another application has allocated 
the device. The DECnet—VAX node and circuit counters are zeroed at the 
beginning of the DECnet—VAX test to allow for failure monitoring during 
the run. 


As with other UETP phases, you can run the DECnet-VAX phase 
individually by following the procedure described in Section 9.4.1. 


Environment 

The DECnet—VAX test will work successfully on VMS systems connected to 
all DECnet—VAX-supported node types, including routing and nonrouting 
nodes and several different types of operating systems (such as RSTS, 
RSX, TOPS, and RT). There must be some sort of default access on remote 
systems to copy files between systems. The DECnet—VAX phase tests the 
following: | 


e The node UETP is running on. 
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All circuits in sequence, unless you have defined the logical name 
UETP$NODE_ADDRESS to be the remote node that you want to run 
the test on. If you have defined a remote node, the DECnet—VAX phase 
test only one circuit. 


All adjacent or first-hop nodes and all circuits in parallel. 


There is no limit on the number of communication lines supported by the 
tests. A test on one adjacent node should last no more than two minutes 
at normal communications transfer rates. 


How the DECnet—VAX Phase Works 
UETP (under the control of UETPHAS00.EXE) reads the file 
UETDNET00.DAT and completes the following steps during the 


DECnet—VAX phase: 

1 Executes a set of Network Control Program (NCP) LOOP EXECUTOR 
commands to test the node on which UETP is running. | 

2 Uses NCP to execute the command SHOW ACTIVE CIRCUITS. The 
results are placed in UETININET.TMP, from which UETP creates 
the data file UETININET.DAT. The UETININET.TMP file contains 
the following information for any circuit in the ON ‘state but not in 
transition: 

e Circuit name 

e Node address 

e Node name (if one exists) 

The UETININET.TMP file is used throughout the DECnet—VAX phase 
to determine which devices to test. | 

3 Uses the UETININET.TMP file to create an NCP command procedure 
for each testable circuit. Each command procedure contains a set of 
NCP commands to zero the circuit and node counters and to test the 
circuit and adjacent node by copying files back and forth. 

Note: If you do not want the counters zeroed, do not test 
DECnet-VAX. 

4 Executes the command procedures from step 3 in parallel to simulate a 
heavy user load. The simulated user load is the lesser of the following 
values: 

e The number of testable circuits, multiplied by two 

e The maximum number of user-detached processes that can be 
created on the system before it runs out of resources (determined 
by UETINITOO) 

5 Executes a program, UETNETSO0.EXE, that uses the 


UETININET.DAT file to check the circuit and node counters for 
each testable circuit. If a counter indicates possible degradation 
(by being nonzero), its name and value are reported to the console. All 


‘counters are reported in the log file, but only the counters that indicate 


degradation are reported to the console. Following is an example of 
UVUETNETSO0 output: 
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%SUETP-S-BEGIN, UETNETSOO beginning at 19-APR-1990 13:45:33.18 
SUETP-W-TEXT, Circuit DMC-0 to (NODENAME1) OK. 

SUETP-I-TEXT, Node (NODENAME2) over DMC-1 response timeouts = 
SUETP-I-TEXT, Circuit DMC-1 to (NODENAME2) local buffer errors 
SUETP-I-TEXT, Node (NODENAME3) over DMP-0 response timeouts = 
SUETP—-S-ENDED, UETNETSOO ended at 19-APR-1990 13:45:36.34 


34. 


W jl 


Because degradation is not necessarily an error, the test’s success is 
determined by you, not the system. The following counters indicate 
possible degradation: 


For Circuits 

e Arriving congestion loss 
e Corruption loss 

e Transit congestion loss 
e Line down 

e Initialization failure 

e Data errors inbound 

e Data errors outbound 
e Remote reply timeouts 
e Local reply timeouts 

¢ Remote buffer errors 

e¢ Local buffer errors 

e Selection timeouts 

e Remote process errors 
e Local process errors 

e Locally initiated resets 


e Network initiated resets 


For Nodes 

e Response timeouts 

e Received connect resource errors 
¢ Aged packet loss 

e Node unreachable packet loss 

e Node out of range packet loss 

¢ Oversized packet loss 

e Packet format error 

e Partial routing update loss 


e Verification reject 
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9.6.5 Cluster-Integration Test Phase 


The cluster-integration test phase consists of a single program and a 
command file that depend heavily on DECnet—-VAX. This phase uses 
DECnet—VAX to create SYSTEST_CLIG processes on each VMS node in 
the cluster and to communicate with each node. SYSTEST_CLIG is an 
account that is parallel to SYSTEST, but limited so that it can only be 
used as part of the cluster-integration test. The following restrictions on 
the SYSTEST_CLIG account are necessary for a correct run of the cluster 
test phase: 


e The account must be enabled and the password must be null. For 
more information, see Section 9.3.13. 


e The UIC must be the same as that of the SYSTEST account. 


e The account must have the same privileges and quotas as the 
SYSTEST account. For more information, see Section 9.5.4.1. 


e The account can allow login only through DECnet—VAX. 


e The account must be locked into running UETCLIGO0.COM when it 
logs in. 


These items are necessary to ensure the security and privacy of your 
system. If the test cannot create a SYSTEST_CLIG process on some VMS 
node, it gives the reason for the failure and ignores that node for the lock 
tests and for sharing access during the file test. Also, the test does not 
copy log files from any node on which it could not create the SYSTEST_ 
CLIG process. If there is a problem communicating with a SYSTEST_ 
CLIG process after the process has been created, the test excludes it from 
further lock and file sharing tests. At the end of the cluster-integration 
test, an attempt is made to report any errors seen by that node. 


UETCLIG00.EXE has two threads of execution: the primary and the 
secondary. The first, or primary thread, checks the cluster configuration 
(VMS nodes, HSC nodes, and the attached disks that are available to 
the node running the test). For selected VMS nodes, the primary thread 
attempts to start up a SYSTEST_CLIG process through DECnet—VAX. 

If the primary thread was able to start a SYSTEST_CLIG process on a 
node, the node runs the command file UETCLIG00.COM, which starts up 
UETCLIGOO.EXE and runs the secondary execution thread. 


The process running the primary thread checks to see that it can 
communicate with the processes running the secondary threads. It then 
instructs them to take out locks so that a deadlock situation is created. 


The primary thread tries to create a file on some disk on selected VMS 
and HSC nodes in the cluster. The primary thread writes a block, reads it 
back, and verifies it. The primary thread selects one VMS node at random 
and asks that node to read the block and verify it. The primary extends 
the file by writing another block and has the secondary read and verify the 
second block. The file is deleted. 
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The secondary processes exit. They copy to the primary process the 
contents of their SYS$ERROR files, so that the UETP log file and console 
report show all problems in a central place. DECnet—VAX automatically 
creates a NETSERVER.LOG in SYS$TEST as the test is run, so that if 
necessary, you can read that file later from the node in question. 


During the test run, the primary process uses the system service 
SYS$BRKTHRU to announce the beginning and ending of the test to 
each VMS node’s console terminal. 


You can define the group logical name MODE to the equivalence string 
DUMP to trace most events as they occur. Note that the logical name 
definitions apply only to the node on which they were defined. You must 
define MODE on each system in the VAXcluster on which you want to 
trace events. 


10 _ Starting and Customizing VMS DECwindows Software _ 


10.1 


10.1.1 


This chapter describes the tasks that you that you must perform to start 
and customize VMS DECwindows software. If you have not installed VMS 
DECwindows software on your system, skip this chapter. Depending on 
your configuration, VMS DECwindows startup and customization tasks 
include the following: 


Starting the VMS DECwindows software as described in Section 10.1. 
Customizing the server startup as described in Section 10.2. 

Using VMS/ULTRIX Connection software as a DECwindows transport. 
Using customer-written transports with DECwindows. 

Defining print formats as described in Section 10.6. 

Compiling the optional Ada software as described in Section 10.7. 


Starting the VMS DECwindows Software 
If you installed VMS Version 5.3 on your system, go to Section 10.1.1. 


If you upgraded your system to VMS Version 5.3, go to Section 10.1.2. 


After an Installation 


After you register the VMS license and reboot the system, DECwindows 
starts automatically (if you installed it). However, if you intend to use 
DECnet—VAX you need to edit SYS$SYSROOT:[SYSMGR]SYSTARTUP_ 
V5.COM and do the following: 


1 


Choose one of the following commands to start the network by 
removing the appropriate comment delimiter (! ): 


$! IF FSSEARCH ("SYSSSYSTEM:NETACP.EXE") .NES "" THEN @SYSSMANAGER: STARTNET 
$! IF FSSEARCH ("SYSSSYSTEM:NETACP.EXE") .NES "" THEN SUBMIT SYSSMANAGER: STARTNET.COM 


2 


Add a comment delimiter (!) to the following command: 
$ DEFINE DECWS$IGNORE_DECNET TRUE 


If you are not going to use DECnet—VAX, or have not yet registered 
the license, leave this command uncommented. This command tells 
VMS DECwindows not to wait for DECnet—VAX. 
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10.1.2 After an Upgrade 


VMS DECwindows software starts automatically after SYSTARTUP_ 
V5.COM runs, however you may need to do the following: 


1 If you upgraded from V5.1, V5.1-1, or V5.1-B, you need to edit 
SYSTARTUP_V5.COM and delete the following line: 


S @SYSSMANAGER : DECWSSTARTUP 


2 Ifyou placed this command in a file other than SYSTARTUP_V5.COM, 
you can either delete the command from the file it is in or add the 
following command to SYSTARTUP_V5.COM: 


$ DEFINE DECWSIGNORE_ DECWINDOWS TRUE ! Delay DECwindows startup 


You should only add the above command to SYSTARTUP_V5.COM 
if your site-specific startup is going to execute DECW$STARTUP 
at a later time. You should execute DECW$STARTUP on all VAX 
computers, including those that are not using VMS DECwindows. 


10.1.3. VMS DECwindows Logical Names Created At Startup 


After you start VMS DECwindows, a system-wide logical name table 
is created and is added to the default logical name table search lists. 
Table 10-1 lists the logical names contained in this table. 


Table 10-1 DECW$LOGICAL_NAMES 


Logical Name 


CDA$LIBRARY 
DECWS$BOOK 
DECW$EXAMPLES 
DECWSINCLUDE 


DECWS$KEYMAP 
DECWS$SYSTEM_DEFAULTS 
DECWS$USER_DEFAULTS 
DECWS$WINMGREXE 


DECW$XLIBERRDB 
UILSINCLUDE 
VUE$LIBRARY 


Definition 


DDIF document style guide. — 
Online documentation. 
DECwindows example files directory. 


DECwindows MIT-compatible C language 
include files. 


DECwindows keyboard map definitions 
directory used by the Session Manager. 


The system-wide directory where DECwindows 
application will look for resource files. 


The user directory where DECwindows 
applications will look for resource files. 


Window manager executable file used by the 
Session Manager. 


Pointer to the Xlib error resource database. 
Directory containing toolkit UIL files. 
Directory containing FileView command files 


and the FileView default system profile. 
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10.2 Customizing the Server Startup 


If you are not planning on starting the VMS DECwindows server, go to 
Section 10.6. 


The startup command procedures automatically determine most of the 
configuration variables for the VMS DECwindows server. However, there 
are four items which the command procedures cannot determine: 


The startup procedures assume that you have a 75 dot per inch (dpi) 
monitor (such as a VR260 or VR290). 


If you have a VAXstation 2000/GPX, a VAXstation 3xxx/GPX, or a 
VAXstation II/GPX, the startup procedures assume that you have a 
color monitor. 


The startup procedures assume that you have a North American 
keyboard layout (you have an LK201-AA or -LA keyboard). 


The startup procedures assume that the server will use only DECnet— 
VAX and local transports. 


If any of these assumptions is incorrect, you must override them as follows: 


1 


Make a copy of the file SYS$MANAGER:DECW$PRIVATE_SERVER. 
SETUP.TEMPLATE and rename it to a .COM file type. The comments 
in this file show how to customize individual workstations by adding 
a section of DCL commands for each workstation. You can also add 
DCL commands to the common section of the server startup file. By 
doing this, you ensure that the customizations you make affect all 
workstations that use the server startup file. 


If your screen supports 100 dpi, add the following line: 
$ DECWSSERVER_ DENSITY == 100 


Add this line to the section for each workstation that has a 100 dpi 
monitor, or add it to the common section for all workstations (if all the 
workstations have 100 dpi monitors). 


The section for any monochrome /GPX workstation should contain the 
following line if you want to override the default: 


S$ DECWSCOLOR == "FALSE" 


To override the default keyboard layout, determine the correct name 
from the model number of your LK201 keyboard, as follows: 


a. Turn the keyboard upside down, and look for a label which specifies 
the model number. The model number should be in a format 
similar to LK201-xx. 


The model number may also be listed as simply LK201. In this 
case, the information you need is in another part of the label where 
there will be a number that has the following format: 


NN-ANNNN xXx. 
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b. Use the xx part of this number to choose a keymap name from 
Table 10-2. The table is arranged based on the dialect that each 
keyboard is designed for. Choose the keymap ending in _DP for 
the data processing keyboard layout, or the keymap ending in _TW 
for the typewriter layout. 


Table 10-2 DECwindows Keymap 


Dialect 


Austrian/German 


Belgian/French 
British 
Canadian/French 


Danish 


Dutch 


Finnish 


Flemish 
icelandic 
italian 


North American 
Norwegian 


Model 
LK201-(AG,LG,BG,MG) 


LK201-(NG,PG) 
LK201-(AP,LP,BP,MP) 
LK201-(AE,LE,BE,ME) 
LK201-(AC,LC,BC,MC) 
LK201-(AD,LD,BD,MD) 
LK201-(ED,RD,FD) 
LK201-(AH,LH,BH,MH) 


LK201-(NH,PH) 
LK201-(AF,LE.BF,MF) 


LK201-(NF,PF) 
LK201-(AB,LB,BB,MB) 
LK201-(AU,LU,BU,MU) 
LK201-(AI,LI,BI,Ml) 


LK201-(AA,LA,BA,MA) 
LK201-(AN,LN,BN,MN) 


LK201-(EN,RN,FN) 


DECwindows Keymap Name 


AUSTRIAN_GERMAN_LK201LG_DP 
AUSTRIAN_GERMAN_LK201LG_TW 
AUSTRIAN_GERMAN_LK201NG_DP 
AUSTRIAN_GERMAN_LK201NG_TW 
BELGIAN_FRENCH_LK201LP_DP 
BELGIAN_FRENCH_LK201LP_TW 
BRITISH_LK201LE_DP 
BRITISH_LK201LE_TW 
CANADIAN_FRENCH_LK201LC_DP 
CANADIAN_FRENCH_LK201LC_TW 
DANISH_LK201LD_DP 
DANISH_LK201LD_TW 
DANISH_LK201RD_DP 
DANISH_LK201RD_TW 
DUTCH_LK201LH_DP 
DUTCH_LK201LH_TW 
DUTCH_LK201NH 
FINNISH_LK201LF_DP 
FINNISH_LK201LF_TW 
FINNISH_LK201NF_DP 
FINNISH_LK201NF_TW 
FLEMISH_LK201LB_DP 
FLEMISH_LK201LB_TW 
ICELANDIC_LK201LU_DP 
ICELANDIC_LK201LU_TW 
ITALIAN_LK201LI_DP 
ITALIAN_LK201LI_TW 
NORTH_AMERICAN_LK201LA 
NORWEGIAN_LK201LN_DP 
NORWEGIAN_LK201LN_TW 
NORWEGIAN_LK201RN_DP 
NORWEGIAN_LK201RN_TW 
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Table 10-2 (Cont.) DECwindows Keymap 





Dialect Model DECwindows Keymap Name 
Portuguese LK201-(AV,LV,BV,MV) PORTUGUESE_LK201LV 
Spanish LK201-(AS,LS,BS,MS) SPANISH_LK201LS_DP 
SPANISH_LK201LS_TW 
Swedish LK201-(AM,LM,BM,MM) SWEDISH_LK201LM_DP 
SWEDISH_LK201LM_TW 
LK201-(NM,PM) SWEDISH_LK201NM_DP 
SWEDISH_LK201NM_TW 
Swiss/French LK201-(AK,LK,BK,Mk) SWISS_FRENCH_LK201LK_DP 
SWISS_FRENCH_LK201LK_TW 
Swiss/German LK201-(AL,LL,BL,ML) SWISS_GERMAN_LK201LL_DP 
SWISS_GERMAN_LK201LL_TW 
Combined US/UK LK201-(EE,RE,PE) UK_LK201RE 
US_LK201RE 





c. After you choose a keymap name, modify the server startup file. 
For example, to change the keyboard layout to a Dutch typewriter 
layout, add the following line to the server startup file: 


S DECWSDEFAULT KEYBOARD MAP == "DUTCH_LK201LH_TW" 


Add a line similar to this for each workstation that doesn’t have a 
North American keyboard layout, or add it to the common section 

for all workstations (if all the workstations use the same keyboard 
layout). 


5 To add support for the Transmission Control Protocol/Internet Protocol 
(TCP/IP) transport using the VMS/ULTRIX Connection product (UCX), 
add the following line: | 


$ DECWSSERVER_TRANSPORTS == "DECNET, LOCAL, TCPIP" 


Add this line to the section for each workstation that will be using 
TCP/IP, or add it to the common section for all workstations. 


To include support for other transports, add the last part of the 
transport image name to the list of transports. For example, suppose 
you want to add support for a customer-written transport that has the 
following image name: 


SYS$SHARE:DECW_TRANSPORT_FOO 
You would add the following line: 
$ DECWSSERVER_TRANSPORTS == "DECNET, LOCAL, FOO" 
6 Reboot the workstations for which you customized the server startup. 


7 Customize security as described in the VMS DECwindows User’s 
Guide. 
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Note: 


After you start the server, a per-server logical name table is created on 
your system but is not added to the default logical name table search lists. 


Table 10-3 lists the logical names. 


These logical names may change in a future release. 


Table 10-3 DECW$SERVER(n)_ TABLE 


Logical Name 


DECW$COLOR 


DECW$DEFAULT_FONT 
DECWS$DEFAULT_KEYBOARD_MAP 
DECWS$FONT 


DECWS$KEYBOARD 
DECWS$KEYMAP 


DECW$MONITOR_DENSITY 


DECWSPOINTER 
DECWS$RGB_xxx 


DECW$SERVER_DISABLE_CH 


DECW$SERVER_SCREENS 


DECWS$SERVER_TRANSPORTS 


DECWS$XSIZE_IN_PIXELS 


DECWS$YSIZE_IN_PIXELS 


10.3. Using TCP/IP with DECwindows 


DECwindows contains support for the TCP/IP transport. This support 
depends on the VMS/ULTRIX Connection software (UCX), which is 
a Digital layered product. Before you can use DECwindows TCP/IP 
transport interface, you must install UCX. For more information about 
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Definition 


Determines whether the server will 
consider a VAXstation/GPX to be color 
or intensity. 


Determines the font which is initially 
loaded in a graphics context. 


Determines which keyboard map file 
the server uses. 


Directory where the server will look for 
fonts. 


Device name for system keyboard. 


DECwindows keyboard map definitions 
directory used by the server. 


Determines what monitor density the 
server will use to calculate the monitor 
size. 


Device name for system pointer. 


Definitions of color names used 
by the XStoreNamedColor and 
XAllocNamedColor requests. 


If defined to be true, server exception 
will cause the server to crash and 
produce a dump file, rather than 
attempt to continue. 


Device name used by the server. 
The first two characters indicate the 
shareable image to be loaded for 
device support (for example, GCA0O:). 


A list of transport types that the 
DECwindows server will load when it 
Starts up. 


Specifies the size of the workstation 
screen. 


Specifies the size of the workstation 
screen. 
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TCP/IP concepts, see the VMS/ULTRIX Connection System Manager’s 
Guide. 


Note: Other vendor’s implementation of TCP/IP transports use different 
call interfaces. For this reason, DECwindows support for TCP/IP 
is compatible only with UCX. 


You can conserve memory and process slots by configuring UCX software 
for the minimum DECwindows requirement to support the X protocol. 
DECwindows only requires that INET_ACP be running. DECwindows 
does not require that the NFS server, the FTPD server, or the remote 
terminal servers be running. For information on how to configure the UCX 
software, see the VMS /ULTRIX Connection Installation Guide. 


10.4 Using Customer-Written Transports with DECwindows 


DECwindows supports DECnet—VAX, local, and TCP/IP transports. 
However, you can use other transports with DECwindows by writing a 
DECwindows transport interface layer. Digital will likely supply new 
transports for various layered products, and third-party vendors can also 
supply new transports, such as other TCP/IP transports. 


For information on writing a transport interface, see the VMS 
DECwindows Transport Manual. 


The transport interface image’s filename must have the following format 
where name is the unique transport name: 

DECWS$TRANSPORT_name (for Digital supplied transports) 
DECW_TRANSPORT_name_ (for customer-written transports) 

Install the image as a protected image in the SYS$SHARE directory 
(as defined by an executive mode logical name). Digital recommends 


that you use the install the image by adding the following line to 
SYSS$SMANAGER:SYSTARTUP_V5.COM: 


S$ INSTALL CREATE SYSSSHARE :DECW_TRANSPORT_name/OPEN/SHARED/HEADER_RES/PROTECTED 


You can also include this command in a startup file that SYSTARTUP_V5 
calls. | 


To use this transport with the DECwindows server, customize the server 
startup as described in Section 10.2. 


10.5 Using the Example Transport 


DECwindows has an example transport interface based upon the UCX 
software. It is similar to the DECwindows TCP/IP transport interface, 
except it includes its own source files and it uses a different port number 
(5000). You can run the example transport interface simultaneously with 
the TCP/IP transport interface. 


If you have installed UCX software, you can install and use the example 
transport by doing the following: 


1 Copy the example transport to the SYS$SHARE directory as follows: 


$ COPY DECWSEXAMPLES : DECWSTRANSPORT_EXAMPLE.EXE SYSS$SHARE: /PROT=W: RE 
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2 Add the following line to SYSSMANAGER:SYSTARTUP_V5.COM: 


$ INSTALL CREATE SYS$SHARE:DECWSTRANSPORT_EXAMPLE /OPEN /SHARED/ HEADER_RES /PROTECTED 


3 Customize the private server startup as described in Section 10.2 for 
TCP/IP, except use the transport name “EXAMPLE”. For example, you 
could add the following line: 


$ DECWSSERVER_TRANSPORTS == "DECNET, LOCAL, TCPIP, EXAMPLE" 
4 Reboot the workstation. 


5 Customize security as described in the VMS DECwindows User's 
Guide for TCP/IP, but use the transport name “EXAMPLE?” instead of 
(QUOTE>(TCPIP). 


6 Create a DECterm window on the workstation and enter the following 
command: 


$ SET DISPLAY /CREATE /NODE=your_ node /TRANSPORT=EXAMPLE 
Substitute the node name of your workstation for your_node. 


7 Run any DECwindows application from the DECterm window. It will 
now use the example transport to display graphics on your workstation 
screen. For example, you would enter the following command to run 
the clock: 


$ RUN SYSSSYSTEM: DECWSCLOCK 





10.6 Defining Print Formats 


10-8 


If you do not want to define print formats on your system, go to 

Section 10.7. The print dialog box is used in many applications for the 
queuing of files or screens to a printer. (See the VMS DECwindows User’s 
Guide for more information about the print dialog box.) By default, all 
printing devices on the system are displayed in the “Printers” listbox. 
However, you can take advantage of a feature where print queues can be 
associated with print formats through the definition of logical names. The 
logical name is defined to be a comma-separated or space-separated list of 
print queues with the first queue being the default choice. 


For example, if DECW$PRINTER_FORMAT_ANSIZ2 is defined to be “MY_ 
PRINTER, CLUSTER_LN03, ANOTHER_LNO3”, when you select “ANSI2” 
from the print format listbox, only MY_PRINTER, CLUSTER_LNO3, and 
ANOTHER_LNO3 will be shown in the printer listbox, with MY_PRINTER 
being the default choice. 


Table 10-4 lists the logical names and the print formats associated with 
each. 
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Table 10-4 Print Dialog Box Logical Names 


Logical name | Print format 
DECW$PRINTER_FORMAT_TEXT Text 
DECW$PRINTER_FORMAT_LINE Line Printer 


DECWS$PRINTER_FORMAT_TERM Terminal 
DECW$PRINTER_FORMAT_ANSI2 ANSI2 


DECWS$PRINTER_FORMAT_ANSI ANSI 
DECWS$PRINTER_FORMAT_REGIS ReGis 
DECWS$PRINTER_FORMAT_TEK Tektronix 
DECW$PRINTER_FORMAT_DDIF DDIF 


The logical names can be defined by system managers in the appropriate 
logical name tables and be overridden by users. 


If you have any of the logical names in Table 10—4 defined in your 
environment, they will serve as the list of printer queue names to be 
presented when the corresponding print format is selected. This method is 
much faster than making the print dialog box derive the names of all the 
queues on the system, most of which are inappropriate for the print format 
under consideration, as the following example shows: 


$ DEFINE DECWS$PRINTER_FORMAT TEXT "CLUSTER_LNO3,CLUSTER PRINT, - 
_° ANSI_ARTWRK,ANSI_ PROTON" 
$ DEFINE DECWSPRINTER_FORMAT LINE "CLUSTER PRINT" 
$ DEFINE DECWSPRINTER_FORMAT ANSI2 "CLUSTER _LNO3,ANSI_ARTWRK,ANSI_ PROTON" 
$ DEFINE DECWSPRINTER_ FORMAT ANSI "CLUSTER_LNO3,ANSI_ARTWRK,ANSI PROTON" 
$ DEFINE DECWSPRINTER_FORMAT REGIS "SYSS$NULL" 


10.7 Compiling Ada Source Files 


If you have not installed Ada programming software on your system, 

skip this section. VMS DECwindows provides programming interface 
definitions for the Ada language. When you select Ada support at the time 
of the VMS DECwindows kit installation, four Ada package source files 
are placed in the SYS$LIBRARY: directory of your system. These files are: 


¢ CDA$CDA_.ADA—Package CDA—Compound Document Architecture 


¢ DDIF$DDIF_.ADA—Package DDIF—Digital Document Interchange 
Format 


¢ DECWS$DWT_.ADA—Package DWT—DECwindows Toolkit 

¢ DECW$X_.ADA—Package X—xXlib 

These package source files can be individually compiled into your Ada 
program libraries or compiled into the systemwide Ada predefined 


library. To make the packages available systemwide, the command file 
SYS$UPDATE:DECW$COMPILE_ADA_UNITS.COM is provided. 
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This command procedure compiles all four packages into the predefined 


_ Ada library, and, if the VAX Source Code Analyzer (SCA) product is 


present, loads SCA analysis data for the packages into the SCA library for 
the predefined library. The command procedure should be run as a batch 
job and should have available a minimum of 2000 pages in the working 
set; however, 3000 pages is preferable. A page file quota of at least 30000 
pages is suggested. 


Once the units are compiled into the predefined Ada library, you must 
execute the following Ada program library manager command to make the 
units visible: 


SACS ENTER UNIT ADASPREDEFINED CDA,DDIF,DWT,X 


You need only to do this once. This step is also performed automatically 
for all Ada program libraries created after the VMS DECwindows units 
are compiled into the predefined library. 


Future installations of VMS DECwindows might replace the Ada packages. 


If so, the new packages must be compiled as shown. If you have already 


entered the units into your own library, you must then execute the 
following command to make your library current: 


SACS REENTER * 


Future installations of VAX Ada might replace the Ada predefined library 
and remove the VMS DECwindows units. If this occurs, execute the 
DECW$COMPILE_ADA_UNITS.COM command procedure again. 


A __ Booting from [SYSF] During an Upgrade 


This appendix describes how to boot the various VAX computers from 
[SYSF]. You must boot from the [SYSF] root during phase 2, 3, and 4 of 
the upgrade procedure. If you need more information on booting, refer to 
the installation and operations guide for your VAX computer. 


A.1 MicroVAX and VAXstation Computers 
The information in this section applies to the following VAX computers: 


VAXstation II, VAXstation II/GPX, and MicroVAX II 
VAXstation 2000 and MicroVAX 2000 

VAXstation 3100 and MicroVAX 3100 series 
VAXstation 3200 and 3500 

VAXstation 3520 and 3540 

MicroVAX 3300, 3400, 3500, 3600, 3800, and 3900 


To boot from [SYSF], enter the BOOT command in the ent format 
and press RETURN: 
>>> B/F0000000 device-name 


Substitute the device name of the system disk for device-name. 


A.2 VAX 8530, 8550, 8700, 8810-N, 8820, 8830, and 8840 
To boot from [SYSF], use the following procedure: 


1 Press CTRL/P. On the VAX 8530, enter the following command at the 
console-mode prompt (>>>) and press RETURN: | 


>>> HALT 


On the VAX 8820, enter the following command at the PS-OS-0> 
prompt and press RETURN: 


PS-OS-0> HALT/CPU=ALL 


2 On the VAX 8530, enter the BOOT command at the console-mode 
prompt (>>>) in the following format: 


>>>B dddn /R5:F0000000 


Substitute BCI, BDA, or UDA for ddd. Substitute the unit number of 
the drive holding the system disk for n. 


On the VAX 8820, enter the BOOT command at the PS-CIO-0> prompt 
in the following format: 


PS-CIO-0>B dddn /R5=F0000000 


Substitute BCI or BDA for ddd. Substitute the unit number of the 
drive holding the system disk for n. 
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A.3 VAX 11/750, VAX 8200, 8250, 8300, and 8350 
To boot from [SYSF], create a command procedure named SYFBOO.CMD. 
To create SYFBOO.CMD, use the following procedure: 
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Note: 


This procedure assumes that you have installed and booted the 
VMS operating system and are logged into the SYSTEM account. 


1 
2 


Make sure that the console media is in the console drive. 


To connect the console drive to the system, enter the following 
commands and press RETURN after each one: 


S RUN SYSSSYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 


Use the Exchange Utility to copy the appropriate boot command 
procedure from the console media to your current directory on the 
system disk. If the system disk is on an HSC drive and you have 


created DEFBOO.CMD, enter the following command and press 
RETURN: 


S$ EXCHANGE COPY CSA1:DEFBOO.CMD * 


On the VAX 11/750, if the system disk is on a local drive, copy the 
boot command procedure that matches the drive that holds the system 
disk. For example, suppose the system disk is on an RP06 drive and 
has a controller designation of A and a unit number of one. Enter the 
following command and press RETURN: 


$ EXCHANGE COPY CSA1L:DA1BOO.CMD * 


Edit the boot command procedure. Change the line that deposits a 
value in register 5 (R5). This line contains the comment /software 
boot flags. The value is a hexadecimal number with eight digits. For 
example: 


D/G RS 0 'software boot flags 


Change the left-most digit of the value to reflect the name of the root 
directory from which you want to boot. For example, to boot from the 
[SYSF] root directory, change the line as follows: 


D/G/L R5 FO0000000 !designated root is SYSF 


Rename the boot command procedure to SYFBOO.CMD. For example, 
if the boot command procedure is DEFBOO.CMD, enter the following 
command and press RETURN: 

$ RENAME DEFBOO.CMD SYFBOO.CMD 

Use the Exchange Utility to copy SYFBOO.CMD back to the console 
media. Enter the following command and press RETURN: 

S$ EXCHANGE COPY SYFBOO.CMD CSA1:SYFBOO.CMD 

When you are finished, enter the following command and press 
RETURN: _ 3 


S DISMOUNT CSA1 
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8 To secure the console media from unauthorized access, you must enter 
the following command and press RETURN: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA1 


To boot from [SYSF], use the following procedure: 


1 Make sure the console media is in the console drive. On the VAX 
11/750, make sure the keylock switch is set to LOCAL. Set the BOOT 
DEVICE switch to position A. 


On the VAX 8200, set the upper keylock switch to ENABLE and the 
lower keylock switch to HALT. 


2 Press CTRL/P. 
3 On the VAX 11/750, enter the following command and press RETURN: 
>>> B/800 DDAO 


On the VAX 8200, enter the following command at the console-mode 
prompt (>>>) and press RETURN: 


>>> B/R5:800 CSA1 
4 Atthe BOOT58> prompt, enter the following command: 
BOOT58> @SYFBOO.CMD 


A.4 VAX 11/730, VAX 11/780, VAX 11/785, VAX 8600, and VAX 8650 


To boot from [SYSF], create a command procedure named SYFBOO.CMD 
(for VAX 11/730, VAX 11/780, and VAX 11/785) or SYFBOO. COM (for 
VAX 8600 and VAX 8650). 








or SYFBOO.COM, use the following procedure: 


1 Make sure that the console media is in the console drive. On the 
VAX 8600, make sure the TERMINAL CONTROL switch is set to 
LOCAL. 


2 Log into the SYSTEM account. 


3 To connect the console drive, enter the following commands and press 
RETURN after each one: 


§ RUN SYSSSYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 


4 Use the Exchange Utility to copy DEFBOO.CMD (for VAX 11/730, 
VAX 11/780, and VAX 11/785) or DEFBOO.COM (for VAX 8600 and 
VAX 8650) from the console media to your current directory on the 
system disk. On the VAX 11/780, VAX 11/785, and VAX 8600, enter a 
command similar to the following and press RETURN: 


S$ EXCHANGE COPY CSA1:DEFBOO.CMD * 


On the VAX 11/730, enter the following command and press RETURN: 
$ EXCHANGE COPY CSA2:DEFBOO.CMD * 
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Edit DEFBOO.CMD or DEFBOO.COM. Change the line that deposits 
a value in register 5 (R5). On the VAX 11/730, VAX 11/780, and 11/785, 
this line contains the comment /software boot flags. On the VAX 8600, 
this line contains the comment /Use Rd for optional boot control flags 
[SYSB.]. The value is a hexadecimal number with eight bits. For 
example: 


DEPOSIT R5 10000000 !software boot flags 


Change the left-most digit of the value to reflect the name of the root 
directory from which you want to boot. For example, to boot from 
[SYSF], change the line as follows: 


DEPOSIT RS FO000000 'software boot flags 


Rename DEFBOO.CMD to SYFBOO.CMD (or DEFBOO.COM to 
SYFBOO.COM), as follows: 


$ RENAME DEFBOO.CMD SYFBOO.CMD 


Use the Exchange Utility to copy SYFBOO.CMD or SYFBOO.COM to 
the console media. Enter a command similar to the following: 


$ EXCHANGE COPY SYFBOO.CMD CSA1:SYFBOO.CMD 


For example, on the VAX 11/730 enter the following command and 
press RETURN: 


$ EXCHANGE COPY SYFBOO.CMD CSA2:SYFBOO.CMD 


When you are finished, enter a command similar to the following and 
press RETURN: 


$ DISMOUNT CSA1 


To secure the console media from unauthorized access, you must enter 
a command similar to the following and press RETURN: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA1 


To boot from [SYSF] during an upgrade, use the following procedure: 


1 


Make sure the console media is in the console drive. On the 

VAX 11/730, VAX 11/780, and VAX 11/785, make sure the keylock 
switch is set to LOCAL. On the VAX 8600, make sure the TERMINAL 
CONTROL switch is set to LOCAL. 


Press CTRL/P. On the VAX 11/780, VAX 11/785 and VAX 8600, enter 
the HALT command at the console-mode prompt (>>>) and press 
RETURN: 


>>> HALT 


Use SYFBOO.CMD to boot from [SYSF]. Enter the following command 
and press RETURN: 


>>> B SYF 


A.5 VAX 6000 Series 
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A.5 VAX 6000 Series 


To boot from [SYSF], use the following procedure: 


1 


A.6 VAXstation 8000 


If you have a CIBCA-A adapter and are booting over the CI, insert the 
console tape cartridge in the console drive. 


Press CTRL/P to put the system in console mode. 

Enter the BOOT command in the following format: 

>>> BOOT /R5:FO0000000 /XMI:a /BI:b [/R3:c] [/NODE:d] DUu 
where: | 

¢ ais the XMI node number of the system disk. 

e 6 is the VAXBI node number of the system disk. 


° c¢ pertains to Volume Shadowing. This qualifier is not required 
unless you are using Volume Shadowing. For more information, 
see the VAX Volume Shadowing Manual. 


e dis the HSC node number of the node being accessed. The /NODE 
qualifier is not necessary if you are booting from a local disk. The 
HSC node number is in hexadecimal. You can deposit a maximum 
of two HSC node numbers (if two HSCs are available). 


e uis the unit number of the drive holding the system disk. 


For example, suppose you want to boot from [SYSF] on an HSC 
disk with a unit number of one and your system has the following 
configuration: 


¢ The disk is connected to the VAXBI at node 2. 

¢ The VAXBI you are using is connected to the XMI at node 3. 
e The disk is available to two HSCs, node numbers OE and 02. 
Enter the following command and press RETURN: 


>>> BOOT/R5:F0000000/XMI:3/BI:2/NODE:0E02 DU1 


To boot from [SYSF], use the following procedure: 


1 


Press CTRL/P to obtain the console prompt. 


2 Enter the boot command in the following format: 


>>> B/R5:F0000000 [ddnu] 


Substitute the boot name of the system disk for ddnu. If you do not 
specify the boot name of the system disk, the VAXstation 8000 boots 
from the disk designated in EEPROM. 
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B  Filesinthe VMS Library and Optional Save Sets 


This appendix lists the contents of the VMS library and optional save sets. 


VMS Library 


Accounting Log Report Generator Utility 
Analyze Object File Utility (ANALYZE/OBJECT) 
Debugger Utility (DEBUG) 

Delta debugger 

DUMP 


EDT documentation 

Error Log Report Generator Utility (ANALYZE/ERROR) 
File Access Control List Utilities 

Files—11 ODS1 ACP 

Foreign terminal support 

FORTRAN require files 

Image Dump Utility (ANALYZE/IMAGE) 
Incoming Remote File Access files 
Incoming Remote Terminal files 

Input Queue Symbiont (Card Reader) 
LAT-11 terminal server (via Ethernet) 
MACRO Assembler 

MACRO Libraries 

MAIL 

Message Utility (MESSAGE) 

Monitor Utility 

National Character Set Utility (NCS) 
Network support 

Network Test files 

Object and Shareable Image libraries 
PHONE 

Print and Batch Queue Utilities 
Programming support 

Remote Task Loading 

RMS Analyze and FDL Editor Utilities (ANALYZE/RMS, 
ANALYZE/FDL) 

RMS Journaling files 

RUNOFF 

SDL intermediary form of STARLET.MLB 
Secure User’s Environment 

Standalone BACKUP 

System Dump Analyzer Utility (ANALYZE/SYSTEM, 
ANALYZE/CRASH) 

System programming support 

System Symbol Table file (SYS.STB) 
TECO editor 

Terminal Fallback Facility 

VAX-C object libraries 
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Files in the VMS Library and Optional Save Sets 
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VAXTPU 

VMS HELP library 

VMS workstation support 

VMS workstation device support 


VMS Optional 
_ BLISS require files 


Example files 

Files for VMS development only 

Files used for kitting 

LPA-11 support 

Miscellaneous files 

Miscellaneous Symbol Table files 
System map 

User Environment Test Package (UETP) 


C DECwindows Software Components Table 


Table C—1 contains the name of each VMS DECwindows software 
component, the directory where the component can be found, a brief 
description of what the component does, and one of the following three 
component classifications: | 


e ALL—Indicates that the component is part of all installations. 
e PROG—Indicates the component is part of the programming 


Table C-1 DECwindows Software Components 


Component 
Directory File Purpose Class 
CDAS$LIBRARY: DEFSTYLE.DDIF DDIF document style guide PROG 
DECWSEXAMPLES: DEMO_BUILD.COM Procedure to compile demo PROG 
sources 
ALLOBJS.H Demo source PROG 
BITMAP.C Demo source PROG 
BITMAP.EXE Demo source PROG 
CLOCK.DDIF Paint example ALL 
DECBURGER.ADA UIL DRM Demo source PROG 
DECBURGER.C UIL DRM Demo souce PROG 
DECBURGER.COM UIL DRM Demo file PROG 
DECBURGER.EXE UIL DRM Demo image PROG 
DECBURGER.FOR UIL_ DRM Demo file PROG 
DECBURGER.UID UIL DRM Demo file PROG 
DECBURGER.UIL UIL DRM Demo file PROG 
DECBURGER_DEFS.FOR UIL DRM Demo file PROG 
DECWS$TRANSPORT_ Demo image PROG 
EXAMPLE.EXE 
DIALOG.C Demo source PROG 
DWTVMSPUSHTEST.B32 XUI toolkit demo PROG 
DWTVMSPUSHTEST.EXE Demo image PROG 
HELLOWORLD.ADA XUI toolkit demo source PROG 
HELLOWORLD.C XUI toolkit demo PROG 


environment. 


e WS—Indicates that the component is part of the workstation device 


support. 
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Table C—1 (Cont.) DECwindows Software Components 





Directory 


DECWS$FONT: 


DECWS$INCLUDE: 
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File 


HELLOWORLD.EXE 
HELLOWORLD.FOR 
HELLOWORLD.UID 
HELLOWORLD.UIL 
ICO.C 

ICO.EXE 
ICOPAS.PAS 
OBJCUBE.H 
OBJICO.H 
OBJTETRA.H 


 PLAID.C 


PLAID.EXE 
POLYINFO.H 
STRINGS.MAR 


XLIBINTRO.ADA 

XLIBINTRO.C 

XLIBINTRO.EXE 
XLIBINTRO.FOR 
XPORTEXAMPLEDEF.R32 
XPORT_EXAMPLE.B32 
XPORT_EXAMPLE_QUEUE.MAR 
XPORT_EXAMPLE_XFER.MAR 


See VMS DECwindows Xlib 
Programming Volume 


COMPOBJ.H 
COMPOBUP.H 
COMPOSITE.H 
COMPOSITEP.H 


CONSTRAINT.H 


Purpose 


XU! toolkit demo image 
XU! toolkit demo 
XUI toolkit demo file 
XUI toolkit demo file 
Demo source 

Demo image 

Demo source _ 
Demo source 

Demo source 

Demo source 

Demo source 

Demo image 

Demo source 


Low-level DECwindows utility 
routine ~ 


Demo source 
Demo source 
Demo image 
Demo source 
Demo source 
Demo source 


‘Demo source 


Demo source 


DECwindows fonts 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 


Xlib and XUl toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 
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Component 
Class 


PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 


PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 


WS 


PROG 


PROG 


PROG 


PROG 


PROG 
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Table C—1 (Cont.) DECwindows Software Components 





Directory 





File 
CONSTRAINP.H 


CONVERT.H 
CORE.H 
COREP.H 
CSTEXTP.H 
CURSORFONT.H 


DECWSDWTDEF.UIL 
DECWDWTAPPLPROG.H 


DECWDWTAPPLPROG.UIL 
DECWDWTWIDGETPROG.H 


DECWMHINTS.H 
DRMDECLS.H 
DRMPUBLIC.H 


DVR$CC_DEF.H 
DVRS$DECW_DEF.H 
DVR$MSG.H 
DWTAPPL.H 


DWTAPPL.UIL 
DWTWIDGET.H 
EVENT.H 
INTRINSIC.H 


INTRINSICP.H 


Purpose 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit © 
programming include files 
Xlib and XUI toolkit 
programming include files 
UIL language include file 
Xlib and XUI toolkit 
programming include files 
XUI toolkit support 

Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include file 
Xlib and XUI toolkit 
programming include file 
CDA Viewer support file 
CDA Viewer support file 
CDA Viewer support file 
Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Component 


Class 


PROG 


PROG 


PROG 


PROG 


PROG 


PROG 


PROG 
PROG 


PROG 
PROG 


PROG 


PROG 


PROG 


ALL 
ALL 
ALL 
PROG 


PROG 


PROG 


PROG 


PROG 


PROG 
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Table C—1 (Cont.) DECwindows Software Components 





Directory 


File 
KEYSYM.H 


KEYSYMDEFH 
OBJECT.H 
OBJECTPH 
RECTOBJ.H 
RECTOBJPH 
SELECTION.H 
SHELL.H 
SHELLP.H 
STRINGDEFS.H 
TRANSLATE.H 
VENDOR.H 
VENDORPH 
WINDOWOBJ.H 
WINDOWOBJPH 
XH 

XATOM.H 
XLIB.H 

XMD.H 


XOS.H 


Purpose 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


— Xlib and XUI toolkit 


programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XU! toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 
Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Xlib and XUI toolkit 
programming include files 


Component 
Class 


PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 
PROG 


PROG 
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Table C—1 (Cont.) DECwindows Software Components 





Component 
Directory File Purpose Class 
XPROTO.H Xlib and XUI toolkit PROG 
programming include files 
XPROTOSTR.H Xlib and XUI toolkit PROG 
programming include files 
XRESOURCE.H Xlib and XUI toolkit PROG 
programming include files 
XUTIL.H Xlib and XUI toolkit PROG 
programming include files 
DECWS$SYSTEM_ DDIF$VIEW.UID CDA Viewer support file ALL 
DEFAULTS: | 
DDIF$VIEWWGT.UID CDA Viewer support file ALL 
DECWS$BOOKREADER.DAT Bookreader support file ALL 
DECW$BOOKREADER.UID Bookreader support file ALL 
DECW$CALC.DAT Calculator support file ALL 
DECWS$CALC.UID Calculator support file ALL 
DECWS$CALENDAR.DAT Calendar support file ALL 
DECWSCALENDAR.UID Calendar support file ALL 
DECWS$CARDFILER.DAT Cardfiler support file ALL 
DECWS$CARDFILER.UID Cardfiler support file ALL 
DECW$CLOCK.DAT Clock support file ALL 
DECW$CLOCK.UID Clock support file ALL 
DECW$LOGIN.DAT Login support file ALL 
DECW$LOGIN.UID Login support file ALL 
DECWS$MAIL.DAT DECwindows VMSmail ALL 
support file 
DECWS$MAIL_MAIN.UID DECwindows VMSmail ALL 
support file 
DECWS$MAIL_MISC.UID DECwindows VMSmail ALL 
support file 
DECWS$MAIL_READ.UID DECwindows VMSmail ALL 
support file 
DECWS$MAIL_SEND.UID DECwindows VMSmail ALL 
support file 
DECW$NOTEPAD.DAT NOTEPAD support file ALL 
DECW$NOTEPAD.UID NOTEPAD support file ALL 
DECWS$PAINT.DAT DECwindows Paint support ALL 


file 
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Table C—1 (Cont.) DECwindows Software Components 


Directory 


SYS$LIBRARY: 





‘Asterisk (*) indicates that BASIC, BLISS, FORTRAN, C, Macro, Pascal, and PLI languages are supported. 





i 


File 
DECWSPAINT.UID 


DECW$PRINTWGT.UID 
DECWS$PRINTWGT_UI.UID 
DECWS$PUZZLE.DAT 
DECW$PUZZLE.UID 
DECWSSESSION. DAT 
DECWS$SESSION.UID 
DECW$SM_BW.DAT 
DECW$SM_COLOR.DAT 
DECW$SM_GENERAL.DAT 
DECW$SM_GRAY.DAT 
DECWS$TERMINAL.DAT 
DECWS$TERMINAL.UID 
DECWS$WINMGR.DAT 
DECWS$WINMGR.UID 
VUE$MASTER.UID 
CDA$ACCESS.EXE 


CDA$CDA_.ADA 
CDA$DEF.*' 


CDA$DTIF_TO_DDIF.EXE 


CDA$MSG."*! 
CDA$WRITE_ANALYSIS.EXE 
DDIF$DDIF_.ADA 
DDIF$DEF."" | 
DDIF$READ_TEXT.EXE 


DDIF$VIEWSHR.EXE 
DDIFSWRITE_PS.EXE 
DDIFSWRITE_TEXT.EXE 


DECWSAILSHR.EXE 


Purpose 


DECwindows Paint support 
file 

Print support file 

Print support file 

Puzzle support file 

Puzzle support file 

Session manager support file 
Session manager support file 
Session manager support file 
Session manager support file 
Session manager support file 
Session manager support file 
Terminal support file 
Terminal support file 

Window manager support file 
Window manager support file 
FileView defaults file 


The DDIF toolkit and DDIF 
converter toolkit Run-time- 
library shareable image 


CDA Ada binding 

DDIF converter language 
binding 

CDA DTIF to DDIF converter 
image 

DDIF message symbols 
CDA image 

DDIF Ada binding 

DDIF language binding 


Text front end shareable 
image 


DDIF viewer shareable image 
Text image 


Text back end shareable 
image 


Image support shareable 
image 
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Component 


| Class 


ALL 


ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
PROG 


PROG 
PROG 


ALL 


PROG 
ALL 
PROG 
PROG 
ALL 


ALL 
ALL 
ALL 


DECwindows Software Components Table 


Table C—1 (Cont.) DECwindows Software Components 





Directory 


File 


DECW$CALENDAR_PROLOG.PS 


DECWS$CURSOR.H 
DECW$DRIVER.MLB 
DECWS$DWT_.ADA 
DECW$DWTDEF.*' 
DECWS$DWTENTRY.* 
DECWS$DWTLIBSHR.EXE 
DECWS$DWTMSG.* 
DECWS$DWTSTRUCT.* 
DECW$DWTWIDGETSTRUCT.* 
DECW$DWTWIDGETDEF.*' 
DECW$LOGINOUT.EXE 


DECWS$MAILSHR.EXE 


DECWS$PRINTWGT.UID 
DECWS$PRINTWGTSHR.EXE 


DECWS$SERVER_DDX_GA.EXE 
DECW$SERVER_DDX_GB.EXE 
DECWS$SERVER_DDX_GC.EXE 
DECW$SERVER_DIX.EXE 
DECWS$SERVER_EXTENSION_ 
PEX.EXE 


DECW$TERMINALSHR.EXE 


DECWS$TRANSPORT_ 
COMMON.EXE 


DECW$TRANSPORT_DECNET.EXE 


DECW$TRANSPORT_LAT.EXE 


DECW$TRANSPORT_LOCAL.EXE 
DECW$TRANSPORT_TCPIP.EXE 


DECWS$UIL.ENV 


Purpose 


Calendar support file 
Cursor include files 
Driver macro library 
Toolkit Ada binding 
Widget include files 


XUI toolkit shareable image 
Toolkit message file 
Widget include files 
Widget include files 
Widget include files 


DECwindows extension to 
VMS loginout image 


DECwindows VMSmail 
shareable image 


Print support file 


DECwindows print widget 
shareable image 


Server color device support 
shareable image 


Server color device support 
shareable image 


Server monochrome device 
support shareable image 


Server device independent 
support 


PHIGS X Server Extension 


Terminal shareable image 


Common transport shareable 
image 


DECnet transport image 
LAT transport image 
Local transport image 
TCP/IP transport image 


LSE template for VIL 
compilier 


Component 
Class 


ALL 

PROG 
PROG 
PROG 
PROG 


PROG 
PROG 
PROG 
PROG 
PROG 
ALL 


ALL 


ALL 
ALL 


WS 
WS 
WS 
WS 
WS 


ALL 
ALL 


ALL 
ALL 
ALL 
ALL 
PROG 





‘Asterisk (*) indicates that BASIC, BLISS, FORTRAN, C, Macro, Pascal, and PL! languages are supported. 
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Table C-1 (Cont.) DECwindows Software Components _ 





Component 
Directory File — Purpose Class 
DECW$X_.ADA - Xiib Ada binding PROG 
DECWS$XLIBDEF.*' Language Xlib binding PROG 
DECW$XLIBMSG.*' Language message symbols PROG 
DECW$XLIBSHR.EXE Xlib shareable image PROG 
~ DECWS$XPORTCOM.H _ Common transport definitions © PROG 
DECW$XPORTCOM.MAR Common transport definitions PROG 
DECW$XPORTCOM.R32 Common transport definitions PROG 
DECW$XPORTDEF.H Transport definitions PROG 
DECWS$XPORTDEF.MAR - Transport definitions PROG 
DECW$XPORTDEF.R32 Transport definitions PROG 
DECW$XPORTMAC.R32 Transport BLISS macros PROG 
DECW$XPORTMSG.R22 | Transport message symbols PROG 
PHIGS$GB_UCODE.EXE PHIGS image WS 
SYS$MANAGER: DECW$CHECK_PARAMS.COM ~ Check AUTOGEN ALL 
parameters 
DECWS$DEVICE.COM Device detection and ALL 
configuration 
DECW$LOGICALS.COM Logical name table ALL 
| | initialization and start 
DECWS$PRIVATE_SERVER_ Server customization ws 
SETUP. TEMPLATE template 
DECW$RGB.COM Definitions of the color WS 
| 7 names used by the 
XStoreNamedColor and 
| 7 XAllocNamedColor requests 
DECW$STARTAPPS.COM User environment ALL 
DECWS$STARTLIBS.COM Programming environment PROG 
| a _ Startup 
DECW$STARTSERVER.COM Server initialization and WS 
startup — 
DECW$STARTSM.COM Starts the session manager § ALL 
DECWS$STARTUP.COM Starts the DECwindows ALL 
~ environment | a 
DECW$SYLOGIN. TEMPLATE _ System login file template = ALL 
SYSSMESSAGE: DDIFSVIEWMSG.EXE Viewer message file ALL 
DECWS$DWTERRDB.DAT Toolkit error support file PROG 





‘Asterisk (*) indicates that BASIC, BLISS, FORTRAN, C, Macro, Pascal, and PLI languages are supported. 





i 
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Table C—1 (Cont.) DECwindows Software Components 





Directory 


SYSSSYSTEM: 


SYS$LOADABLE_ 


IMAGES: 


File 

DECWS$DWTMSG.EXE 
DECWS$TERMINALMSG.EXE 
DECW$TRANSPORTMSG.EXE 
DECWS$XLIBERRDB.DAT 
DECWS$XLIBMSG.EXE 


CDA$CONVERT.EXE 
DDIF$VIEW.EXE 
DECWS$BOOKREADER.EXE 
DECWS$CALC.EXE 
DECWS$CALENDAR.EXE 
DECW$CARDFILER.EXE 
DECWS$CLOCK.EXE 
DECWS$FONTCOMPILER.EXE 
DECWS$MAIL.EXE 
DECWS$NOTEPAD.EXE 
DECWSPAINT.EXE 
DECW$PUZZLE.EXE 
DECWS$SERVER_MAIN.EXE 
DECW$SESSION.EXE 


DECWS$SETSHODIS.EXE 
DECWS$STARTLOGIN.EXE 


DECWSTERMINAL.EXE 
DECWS$TERMINAL_CREATE.EXE 
DECWS$UILCOMPILER.EXE 
DECWSWINMGR.EXE 


VUE$MASTER.EXE 
GAADRIVER.EXE 


GABDRIVER.EXE 
GBBDRIVER.EXE 
GCADRIVER.EXE 


Purpose 

Toolkit message file 
DECterm message file 
Transport message image 
Xlib resource database 
Xlib message image 


DDIF converter image 
DDIF viewer 
Bookreader image 
Calculator image 
Calendar image 
Cardfiler image 

Clock image 

Font compiler image 
DECwindows VMSmail image 
Notepad image 

Paint image 

Puzzle image 

Server main image 


Manages the session and 
contains the control panel 


SET/SHOW DISPLAY 
command image 


Starts the DECwindows 
LOGINOUT.EXE image 


Terminal emulator controller 
DECterm image 
UIL compiler 


DECwindows window 
manager 


FileView image 
VAXstation II/GPX driver 


VAXstation 2000/GPX driver 
VAXstation 35x0 driver 


VAXstation !l monochrome 
device driver 


Component 
Class 


PROG 
ALL 
ALL 
PROG 
PROG 


ALL 


ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
WS 
ALL 


PROG 


ALL 


ALL 
ALL 
PROG 
ALL 


ALL 
WS 


WS 
WS 
WS 
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Table C—1 (Cont.) DECwindows Software Components 


Directory 


DECWS$BOOK: 


DECWS$KEYMAP: 


SYS$HELP: 


SYS$UPDATE: 


C—10 


File — 
GCBDRIVER.EXE 


IKDRIVER.EXE 
IMDRIVER.EXE 
INDRIVER.EXE 
PYDRIVER.EXE 
TWDRIVER.EXE 


WSDRIVER.EXE 


BOOKREADER.DECW$BOOK 


LIBRARY.DECW$BOOKSHELF 
*. DECW$KEYMAP 


DDIF$VIEW.HLB 
DECW$BOOKREADER.HLB 
DECWS$CALC.HLB 
DECW$CALENDAR.HLB 
DECWS$CARDFILER.HLB 
DECW$CLOCK.HLB 
DECW$HELPHELP.HLB 
DECWS$MAIL.HLB 
DECW$NOTEPAD.HLB 
DECWSPAINT.HLB 
DECW$PRINTWGT.HLB 
DECW$PUZZLE.HLB 
DECWS$SESSION.HLB 
DECW$TERMINAL.HLB 
DECW$VUE.HLB 
DECW$COMPILE_ADA_ 


UNITS.COM 


DECWSKITBLD.DAT 
DECWS$KITBLD.IDX 
DECWSTAILOR.EXE 
DECW$TAILOR_ON. TEMPLATE 


Purpose 

VAXstation 2000 
monochrome device driver 
Keyboard decoder driver 
Mouse decoder driver 
Common input function driver 
Pseudo terminal driver 
Pseudo terminal driver 

Set display driver 


Online user’s guide for the 
Bookreader 


Bookreader bookshelf 
DECwindows Keymap files 


View help file 

Bookreader help file 
Calculator help file 
Calendar help file 
Cardfiler help file 

Clock help file 

HELP help file 

Mail help file 

Notepad help file 

Paint help file 

Print help file 

Puzzle help file 

Session Manager help file 
Terminal Emulator help file 
FileView help file 

Ada build file 


Installation support file 
installation support file 
Tailoring program 
Tailoring support file 
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Component 
Class 


WS 


WS 
WS 
WS 
ALL 
ALL 
ALL 


ALL 


ALL 
WS 


ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
PROG 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
ALL 
PROG 


ALL 
ALL 
ALL 
ALL 
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Component 
Directory File Purpose Class 
VUES$LIBRARY: VUE$*.COM FileView verb command files ALL 
VUE$SYSTEM_PROFILE.VUE$DAT _ FileView default system ALL 


profile 
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Layered Products Caution 


Because of the way the VMS Version 5.3 upgrade procedure is designed, 
you should not have to re-install most layered products after the upgrade. 
If a product is available (refer to Table D-1), yet exhibits unexpected 
behavior once Version 5.3 is running, check the VMS Version 5.3 Release 
Notes for layered product restrictions. If problems persist, contact your 
Digital support representative. 


Table D-1 lists the most recent versions of layered products that are 
supported for VMS Version 5.3 as of October 12, 1989. As this list is 
subject to change, Digital recommends that you refer to the System 
Support Addendum and Release Notes of each layered product for the 
latest information. 


Table D-1 Layered Products Currently Available for VMS Version 5.3 








Product Name Most Recent Version Number 
3270 Terminal Option Software 1.0 
AAF01/VMS Subroutine Library 2.0 
ADF01/VMS Subroutine Library 4.0 
ALL-IN-1 2.3 
ALL-IN-1 Starter 1.0 
ALL-IN-1 System for Sales and Marketing 1.2 
Baseview 1.2 
C.A.S. Delivery System 1.6 
CDA Converter Library for VMS 1.0 
CMR21 Host Utility 1.1 
Courseware Authoring System 1.6 
Courseware Design System 1.6 
DEC Capacity Planner for VMS 1.0 
DEC GKS for VMS 4.0 
DEC PHIGS for VMS 2.0 
DECdecision 1.0 
DECdx/VMS 1.2 
DECforms 1.1 
DECimage Application Services for VMS 2.0 
DECimage Scan Software for VMS 2.0 
DECintact 1.1 
(continued on next page) 
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Layered Products Caution 


Table D—1 (Cont.) Layered Products Currently Available for VMS Version 5.3 


Product Name Most Recent Version Number 
DECnet Router Server 1.2 
DECnet/SNA Data Transfer Facility 2.0 
DECnet/SNA Gateway 7 1.5 
DECnet/SNA Gateway for Channel Transport 1.0 
DECnet/SNA Gateway for Synchronous Transport 1.1 
DECnet/SNA VMS 3270 Data Stream Programming Interface 1.4 
DECnet/SNA.VMS 3270 Terminal Emulator 1.5 
DECnet/SNA VMS APPC/LU6.2 Programming Interface 2.1 
DECnet/SNA VMS Application Programming Interface 2.3 
DECnet/SNA VMS DISOSS Document Exchange Facility 1.4 
DECnet/SNA VMS Distributed Host Command Facility 1.2 
DECnet/SNA VMS Gateway Management 2.0 
DECnet/SNA VMS Printer Emulator 1.2 
DECnet/SNA VMS Remote Job Entry 1.4 
DECnet-VAX 5.3 
DECpage 3.0 
DECrouter 200 , 1.1 
DECrouter 2000 1.1 
DECserver 100 for VMS and MicroVMS 2.0 
DECserver 200 for VMS and MicroVMS 3.0 
DECserver 300 for VMS 1.0 
DECserver 500 for VMS 2.0 
DECtalk Mail Access 1.1 
DECvoice Software 1.0 
DECwindows DECnet/SNA 3270 Terminal Emulator for VMS 1.0 
DECwrite for VMS 1.0 
Ethernet Terminal Server for VMS and MicroVMS 3.0 
External Document Exchange with IBM DISOSS 2.1 
Fortran IV/VAX to RSX 2.8 
IEX-VMS-Driver 4.0 
Internet Portal 1.0 
KMV1A MicroVAX Driver 2.1 
KMV1A MicroVAX Driver and Development Tools 2.1 
KMV1A MicroVAX Driver and X.25 Link Level Software 24 
LAN Traffic Monitor 1.1 
LCGO1 Software 7 : 1.5 
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Table D-1 (Cont.) Layered Products Currently Available for VMS Version 5.3 


Product Name 


Layered Products Caution 


Most Recent Version Number 





MicroVAX VSV21 Support Software 
MicroVAX/DRQ3B Device Driver 
MicroVAX MIRA Switch Control 
MUXserver 100 Remote Terminal Server 
MUXserver 300 Remote Terminal Server for VMS 
NMCC/DECnet Monitor 

NMCC/VAX ETHERnim 

PBXserver 

PCLAN/Server VMS 

PDP-11 DATATRIEVE/VAX 

PDP—11 FORTRAN-77/VAX to RSX 
PDP-11 Symbolic Debugger/VAX to RSX 
PLXY-11/VAX 

ReGIS Software 

Remote Bridge Management Software 
Remote System Manager 

Session Support Utility 

Terminal Server Manager 

ULTRIX Mail Connection 

VAX 2780/3780 Protocol Emulator 

VAX 3271 Protocol Emulator 

VAX ACMS 

VAX Ada 

VAX ADE 

VAX APL 

VAX BASIC 

VAX BCP 

VAX BLISS-32 Implementation Language 
VAX C 

VAX CDD/Plus 

VAX COBOL 

VAX COBOL Generator 

VAX Computer Integrated Telephony Applications Interface 
VAX Computer Integrated Telephony PBX Server 
VAX CoProcessor/RSX 

VAX DAL 


3.0 
1.2 
2.1 
1.0 
1.0 
2.1 
2.1 
2.1 
2.2 
3.3 
5.3 
2.1 
1.4 
1.1 
1.2 
2.2 
1.1 
1.3 


1.0 


1.7 
2.4 
3.1 
2.0 
2.4 
3.1 
3.3 
1.1 
4.6 
3.0 
4.1 
4.2 
1.3 
1.1 
1.1 
1.0 
1.6 
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Product Name 


VAX Data Distributor 

VAX DATATRIEVE 

VAX DBMS 

VAX DEC/CMS 

VAX DEC/MAP 

VAX DEC/MMS 

VAX DEC/Shell 

VAX DEC/Test Manager 

VAX DECalc 

VAX DECaic-Plus 

VAX DECalc/DECgraph Package 
VAX DECgraph 

VAX Decision Expert for VMS 
VAX DECrad 

VAX DECscan VMS and ELN Bitbus Drivers 
VAX DECscan VMS Software Toolkit 
VAX DECslide 

VAX DECspelil Verifier/Corrector 
VAX DIBOL 

VAX Distributed File Service 
VAX Distributed Name Service 
VAX Distributed Queuing Service 
VAX DOCUMENT 

VAX DSM 

VAX DT07 

VAX DY32 

VAX EDCS 

VAX Encryption 

VAX FMS 

VAX FORTRAN 

VAX FTAM 

VAX Grammar Checker 

VAX Jukebox Control Software 
VAX KCT32 

VAX Key Distribution Center 
VAX KMS11-BD/BE HDLC/BSC Framing Software 


Most Recent Version number 


2.0-1 
4.2 
4.1 
3.2 
2.1 
2.5 
2.1 
3.0 
3.0 
3.0 
3.0 
1.5 
1.0 
3.2 
2.1 
2.0 
1.3 
1.1 
4.0 
1.2 
1.1 
1.1 
1.2 
5.1 
3.0 
3.0 
1.2 
1.1 
2.4 
9.3 
1.1 
1.0 
1.0 
2.0 
1.1 
2.0 
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Product Name 


VAX KMS11-BD/BE X.25 Link Level Software 
VAX Language Sensitive Editor 

VAX LIMS/SM 

VAX LISP for VMS Systems 

VAX LNO3 image Support Software 

VAX Message Router 

VAX Message Router/P Gateway 

VAX Message Router/S Gateway 

VAX Message Router Telex Gateway 

VAX Message Router X.400 Gateway 
VAX Notes 

VAX OPS5 

VAX OSI Application Kernel 

VAX Packetnet System Interface 

VAX Packetnet System Interface Access 
VAX Pascal 

VAX PBX/Facilities Management 

VAX Performance Advisor 

VAX Performance and Coverage Analyzer 
VAX PL/I 

VAX PrintServer Client Software 

VAX PrintServer Supporting Host Software 
VAX Public Access Communications 

VAX Rally 

VAX Rdb/ELN 

VAX Rdb/VMS 

VAX ReGIS to Sixels Converter 

VAX Remote Environmental Monitoring Software 
VAX RMS Journaling 

VAX RPG I 

VAX Scan 

VAX ScriptPrinter Software 

VAX Software Project Manager 

VAX Source Code Analyzer 

VAX Software Performance Monitor 

VAX SQL/Services 


Layered Products Caution 


Most Recent Version Number 


2.0 
2.3 
1.4 
3.0 
1.0 
3.1 
1.1 
1.1 
1.0 
2.1 
2.0 
3.0 
1.1 
4.2 
4.2 
3.9 
3.0 
2.0 
2.1 
3.3 
3.0 
3.1 
1.2 
2.1 
2.2 
3.0 
1.0 
1.1 
9.3 
2.1 
1.1 
2.1 
1.2 
1.3 
3.4 
1.0 
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Table D-1 (Cont.) Layered Products Currently Available for VMS Version 5.3 


Product Name 


VAX Storage Library System 
VAX TDMS 

VAX TEAMDATA 

VAX TU70/72 Device Driver 
VAX Volume Shadowing 

VAX VTX 

VAX Wide Area Network Device Drivers 
VAX XWAY 

VAX-11 RSX 

VAXcluster Console System 
VAXcluster Software 

VAXELN Ada 

VAXELN Toolkit 

VAXLAB Software Library 
VAX\link for IMS and VSAM Client 
VAXpec for VMS 

VAXset 

VIDA for DB2 

VIDA with IDMS/R 

VMS Workstation Software 
VMS/SNA 

VMS/ULTRIX Connection (tm) 
WPS-PLUS/VMS 

X25Portal 2000 

X25Router 2000 


t 


Most Recent Version Number 


2.0 
1.8 
1.3 
1.2 
5.3 
4.0 
1.1 
1.1 
2.4 
1.2 
5.3 
2.0 
4.0 
1.3 
1.0 
1.0 
8.0 
1.0 
2.2 
4.2 
2.0 
1.0 
3.1 
1.0 
1.0 


- Release Notes for the VAX 8200 


If you are installing the VMS operating system on a VAX 8200 from an 
HSC disk drive, read this section before you perform the installation. 





E.1 How to Proceed 


If you have edited the CIBOO.CMD file on the console RX50 to reflect 
your system configuration, you can use the BOOT58 program and a 
modified version of CIBOO.CMD (DEFBOO.CMD) to boot the VMS 
operating system automatically from an HSC disk drive. To install the 
VMS operating system, follow the instructions in Chapter 2. 


If you have not edited the CIBOO.CMD file to reflect your system 
configuration, the BOOT58 program displays syntax error messages 
when you try to boot the VMS operating system automatically. You must 
deposit values at the BOOT58> prompt to boot the VMS operating system 
manually from an HSC disk drive. If you have not edited CIBOO.CMD, 
install the VMS operating system as described in Section E.2. 


Once you have installed and booted the VMS operating system and are 
logged in to the SYSTEM account, you can edit CIBOO.CMD. Then you 
can use a modified version of CIBOO.CMD (DEFBOO.CMD) to perform 
subsequent boots. 


E.2 Installing the VMS Operating System 


If you have not edited CIBOO.CMD, follow this procedure to install the 
VMS operating system from an HSC drive. _ 


Prepare for the installation as described in the VMS Installation and 
Operations: VAX 8200, 8250, 8300, 8350. Obtain the following information 
from either the network or VAXcluster manager: 


e VAXBI node number 

¢ HSC node number 

e HSC controller number or numbers 
e Unit number of the disk drive 


Then boot standalone BACKUP as follows: 


1 Identify the disk drive that contains the distribution disk and the HSC 
that controls it. You need to know the node number of the HSC and 
the unit number of the disk drive. 


Make sure the console RX50 is in the console diskette drive, CSA1. 


3 To start the BOOT58 program, enter the following command and press 
RETURN: | 


>>> B/R5:800 CSA1 
E—1 
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E-2 


4 At the BOOT58> prompt, deposit the following values. Note that all 
numeric entries are made using hexadecimal notation. 


Note: 


Deposit the value 20 for the type code for the boot device for 
the HSC on a CIBCI or CIBCA device into register 0 using the 
following command: | 


BOOTS8> D/G 0 20 


Deposit the VAXBI node number into register 1 using the following 
format: 


BOOTS58> D/G 1 node-number 


For example, if the VAXBI is node 6, enter the following and press 
RETURN: 


BOOT58> D/G 1 6 


Deposit the. HSC node number into register 2 using the following 
format: 


BOOT58> D/G 2 node-number 


For example, if the HSC is node 12 on a CIBCI device, enter the 
following command and press RETURN: 


BOOT58> D/G 2 C 

If the drive holding the system disk is accessible to 
two HSCs, deposit both node numbers. Put the greater 
number in hexadecimal digits 3 and 2, and the lesser 
in digits 1 and 0. For example, suppose one HSC is 


numbered 18 (hexadecimal 12) and the other is numbered 
10 (hexadecimal A), enter the following and press RETURN: 


BOOTS8> D/G 2 120A 


Deposit the unit number of the drive holding the system disk into 
register 3 using the following format: 


BOOTS8> D/G 3 unit-number 


For example, if the drive holding the system disk is unit 
number 21, deposit hexadecimal 15 into register 3: 


BOOT58> D/G 3 15 


Deposit the number of the correct root directory from which to boot 
using the following format (where r is the directory root): 


BOOTS58> D/G 5 r0000000 


By default, the VMS operating system is in SYSO. For example, 
if the correct root directory is SYSO, enter the following and press 
RETURN: : 


~BOOTS8> D/G 5 0 
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f. Enter the following commands and press RETURN after each one: 
BOOT58> D/G 4 0 
BOOT58> D/G E 200 
BOOT58> LOAD VMB.EXE/START: 200 
BOOT58> START 200 


The procedure may ask for the date and time. Enter the date and time 
using the 24-hour clock format and press RETURN. For example: 


VAX/VMS Version V5.3 Major version id = 01 Minor version id = 00 

PLEASE ENTER DATE AND TIME (DD—MMM-YYY HH:MM:) 19-APR-1990 13:00 

The procedure displays a list of the local devices on your system and, 
if you have them, HSC- and MSCP-served devices. For example: 


Available device DJA2 device type RA60 
Available device DJA3 device type RA60 


Check the list of devices. If the list is incomplete, make sure that all 
the drives are connected properly to the system. See your hardware 
manuals for details. 


When standalone BACKUP finishes booting, it displays an 
identification message followed by the dollar sign prompt ($): 


SBACKUP-I-IDENT, Stand-alone BACKUP V5.3; the date is 19-APR~-1990 13:00:00.00) 
$ 


Continue installing the VMS operating system as described in Chapter 2. 


E.3 Editing CIBOO.CMD 


Once you have installed and booted the VMS operating system and are 
logged.in to the SYSTEM account, edit the CIBOO.CMD file using the 
following procedure: 


Note: If you are editing CIBOO.CMD on a hardcopy terminal you must 
use line mode edit. You might want to use a video display terminal 


instead. 
1 Make sure the console RX50 is in the console diskette drive, CSA1. 
2 To connect the console drive to the system, enter the following 
commands and press RETURN after each one: 
$ RUN SYSSSYSTEM: SYSGEN 
SYSGEN> CONNECT CONSOLE 
SYSGEN> EXIT 
3 Use the Exchange Utility to copy CIBOO.CMD to the system disk. 
Enter the following command and press RETURN: 
$ EXCHANGE COPY CSA1:CIBOO.CMD *.* 
4 To edit CIBOO.CMD, enter the following command and press 


RETURN: 7 


$ EDIT CIBOO.CMD 


E-3 
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D/G E 200 


CIBOO.CMD contains the following text: 
!CIBOO.CMD sBoot command file to boot a VAX 8200/8300 from an HSC disk. 
t 


{ 
{Note "n", "p"™ (and "q"), "u", and "r" are single hexadecimal characters 
{ 

D/G 0 20 


CI Port Device Type Code 
!1D/G ln n = CI adaptor’s VAXBI node number 
!1D/G 2 p Use the HSC controller at CI node p 
!D/G 2 Op0q Use either the HSC controller at CI nodes p and q 
!1D/G 3 u u = Disk drive unit number 
D/G 4 0 Boot Block LBN (not used) 


!1D/G 5 r0000000 r = system root [SYSR...], Software boot flags 
Address of Working Memory+%*X200 
Load Primary Bootstrap 


Start Primary Bootstrap 


LOAD VMB.EXE/START:200 
START 200 


ee ee ee ee ee ee ee ee) 


a. Delete the comment character (!) that appears before the 
D/G 1 command and replace n with the VAXBI node number of the 
CI adapter. 


b. If your computer is only connected to one HSC controller, delete 
the comment character (!) that appears before the first 
D/G 2 command. Replace p with the HSC controller number in 
hexadecimal notation. Delete the second D/G 2 command. 


If the drive holding the system disk is connected to two HSC 
controllers, do the following: 


e Delete the comment character (!) that appears before the 
second D/G 2 command 


e Replace p with the controller number of the first HSC in 
hexadecimal notation 


e Replace g with the controller number of the second HSC in 
hexadecimal notation 


¢ Delete the first D/G 2 command 


c. Delete the comment character (!) that appears before the 
D/G 3 command and replace u with the unit number of the HSC 
drive from which you will boot the VMS operating system. Use 
hexadecimal notation. 


d. Delete the comment character (!) that appears before the 
D/G 5 command and replace r with the number of the correct 
root directory from which to boot. By default, the VMS operating 
system is in SYSO. 


e. Exit from the editor. 
Rename the file. Enter the following command and press RETURN: 


$ RENAME CIBOO.CMD DEFBOO.CMD 


‘Use the Exchange Utility to copy DEFBOO.CMD to the console RX50. 


Enter the following command and press RETURN: 
$ EXCHANGE COPY DEFBOO.CMD CSA1:DEFBOO.CMD 


When you are finished, enter the following command and press 
RETURN: 


$ DISMOUNT CSA1 
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9 To secure the console from unauthorized access, you must enter the 
following command and press RETURN: 


$ MOUNT/FOREIGN/SYSTEM/NOWRITE/NOASSIST CSA1 


If you change the system configuration, use the previous procedure to 
modify CIBOO.CMD. 


E-5 


FE Using DECWSTAILOR to Install DECwindows 


The VMS upgrade and installation procedures give the opportunity to 
install VMS DECwindows software. If you decide you want install 
VMS DECwindows software after a VMS installation or upgrade, use 


DECWS$TAILOR as follows: 
1 Log in to the SYSTEM account. 
2 Enter the following command, and press RETURN: 


$ RUN SYSSUPDATE:DECWS$TAILOR 
DECWS$TAILOR displays the following message: 


Do you want to tailor files "ON" or "OFF"? 
Type ON and press RETURN. 


Follow the instructions given in the screen displays. The 
DECWS$TAILOR program is intended to be self-explanatory. 


When tailoring VMS DECwindows files, consider the following: 


Note: 


Applications filese—VMS DECwindows provides a variety of 
applications; including the following: Bookreader, Calculator, 
Calendar, Cardfiler, Clock, DDIF Document Viewer, EVE Text Editor, 
FileView, Mail, Notepad Text Editor, Paint Graphics Editor, DECterm, 
the Session Manager, and the Icon Box. If you are installing VMS 
DECwindows on a VAXstation, you need these files. You may also 
want these files on a nonworkstation VAX computer, because you 

can run VMS DECwindows applications on a nonworkstation VAX 
computer and display them on a workstation. 


Device support files—If you are installing VMS DECwindows on a 
VAXstation or in a cluster that includes VAXstations, you need these 
files. Otherwise you do not need them. 


If you tailor device support files ON or OFF, the system reboots. 


100 dots-per-inch (100DPI) video font files—If you have a workstation 
monitor capable of displaying 100 dpi (for example, a VR150, VR160, 
or VR295), selecting 100 dpi fonts will give you a more readable 
display when you run VMS DECwindows applications. If your 
workstation monitor cannot display 100 dpi fonts (for example, a 
VR260 or VR290), you can save disk space by not selecting this option. 
For more information on the capabilities of your particular monitor, 
see the owner’s guide for your monitor. 


F—1 
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Programming support files—The VMS DECwindows programming 
support files are needed only to develop applications and are not 
required to run VMS DECwindows applications. Support files 

are supplied for the following VAX programming languages: Ada, 
BASIC, BLISS, C, FORTRAN, MACRO, Pascal, and PL/1. In addition, 
support files are supplied for programming in the C language using 
conventions and standards developed at Massachusetts Institute of 
Technology. 








Ada 
compiling source files > 10-9 
programming interfaces» 10-9 
AUTOGEN 
at end of phase upgrade * 7-12 
FEEDBACK datas 5—1 
AUTOGEN.PAR 
creation of* 7-10 


Boot command procedures 


See DEFBOO and dddGEN 
Bugcheck message 
during UETP * 9-27 


C 


CIBOO.CMD « E-1 
editing E-3 
example « E-4 

Cluster upgrade 
See Concurrent upgrade 


See Rolling upgrade 
Command procedures 
processed during upgrade +* 8-2 
Concurrent upgrade 
descriptions 6-1 
pre-upgrade procedure * 6-1 to 6-2 
procedure* 6-1 to 6-2 
summary» 6—1 
Console media 
needed for an installation» 2~—2 
CTRLNAME logical name + 9-8, 9-29 











D 


dddGEN 
restoring original versions during upgrade « 7-10 
DECnet—VAX 
configuration database * 8-2 
error message during UETP + 9-25 
preparing for UETP + 9—10 
registering the license» 3—1 
requirement for upgrade + 5-5 
security measures * 8~2 
UETP test of* 9-33 
UETP test phase * 9-32 
DECWS$TAILOR 
adding files to a system disk» 8-9 
removing files from a system disk» 3-4, 8-9 
using to install DECwindows « F—1 
DECwindows 
See VMS DECwindows 
DEFBOO 
restoring original versions during upgrade» 7—10 
Device 
format for upgrade * 7-2 
HSC name format for upgrade * 7-2 
Device test (in UETP) 
running individually » 9-29 
Diagnostics 
relationship to UETP * 9-14 
Digital Small Storage Interconnect (DSSI) disks 
device name changes 2-4 
Directories 
user, processed during upgrade» 7-9 
Disk 
See System disk, User disk 
Distribution volume 
use during upgrade * 7—1 


E 


Error during UETP 
diagnosing « 9-14 
sources of * 9-15 
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index 


Error during upgrade 


cluster hang during shutdown « 6-3 
during console update + 8-6 
while entering device code * 7-2 
Error Log Utility | 
relationship to UETP + 9-2, 9-14, 9-25 
Ethernet 
defining a remote node for UETP + 9-16 
preparing for UETP + 9-6 
EXPECTED_VOTES parameter+ 8-2 


H 


Hang 


See System hang 

HSC (Hierarchical Storage Controller) 
device format for an installation « 2-6 
device format for upgrade * 7-2 
displaying name * 2-3 





Installation procedure 
definition > 1-1 
for VAX 8200+ E—1 to E-5 
stages of* 2-2 
Interrupt 
upgrade before Phase 1+ 7-3 


K 


Keyboard layout» 10-3 
customizing « 10-3 
list of* 10-4 
Keyboard model numbers 10-3 
Keymap name 
determining» 10-3 


L 


License registration | 
for system integrated products * 3-1 
for VMS« 3-1 
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Line printer 
preparing for UETP* 9-2, 9-4, 9-6 
UETP output» 9-30 
UETP test image * 9-31 
UETP test of * 9-28 
LOADS logical name + 9-32 
Load test | 
defining user load for UETP* 9-12 
description * 9-31 
error during UETP * 9-24 
running individually « 9-11 
Local Area VAXcluster, upgrade requirement+ 4-3 


Log file generated by UETP 


See also UETP.LOG 
during the load test» 9-24 
NETSERVER.LOG + 9-23 
OLDUETP.LOG* 9-17 
Logical names « 10-6 
for DECwindows* 10-2 
Logical name used by UETP 
CTRLNAME « 9-29 
LOADS « 9-32 
SYSSINPUT * 9-29 
SYS$OUTPUT + 9-30 


Magnetic tape 
preparing for UETP + 9-2, 9-4, 9-5 
test of* 9-28, 9-30 
UETP test image * 9-31 

Master command procedure 


See UETP.COM 

Mixed-interconnect configuration, upgrade 
requirements 4-3 

Mixed-version cluster 

upgrading tos 6-2 to 6-3 
MODE « 9-36 
MODE logical name « 9-15 
MODPARAMS.DAT 

modifying for clusters 8-2 

modifying for single system * 8-2 
Monochrome workstation * 10-3 


N 


NETCONFIG_UPDATE.COM procedure 
- example« 8-3 | 








NETCONFIG_UPDATE.COM procedure (cont'd.) 
running * 8-2 

Network 
requirement for upgrade « 5—5 
restriction on upgrade* 4-2 


O 


Output during UETP 
terminal and line printer * 9-30 


P 


Page file 

size required for upgrade « 5—4 
Password 

modifying for upgrade, VAX-11/750* 7-5 
Phase controller for UETP 

See UETPHASO0.EXE 
Print Dialog Box 

logical names 10-8 
Print formats 

defining for VMS DECwindows« 10-8 
Print queue ; 

associating with a print format* 10-8 
Privilege 

required for UETP * 9-20 © 
Products (VMSINSTAL) 

specification for upgrade *« 7-2 


Q 


Queues 
requirement for upgrade « 5—5 
QUORUM parameter 
setting for concurrent upgrade » 6-2 
setting for rolling upgrade « 6-3 
Quota 
required for UETP * 9-20 


R 


RMS Journaling 
registering the license + 3—1 














index 


Rolling upgrade 
description» 6—1 
procedure * 6~2 
VMS version requirement + 4—1 


S 


Satellites nodes 

upgrade requirement* 4—3 
Server startup* 10-6 
Single system upgrade 

procedure * 7-1 to 7-12 
Source-drive 

definition * 2-1, 7—1 
STARTUP_P1 parameter 

requirement for upgrade» 5—4 
SYSS$INPUT logical name + 9-29 
SYSS$OUTPUT logical name» 9-30 
SYS$TEST logical name + 9-3, 9-9, 9-17 
SYSGEN 

parameter requirement for upgrade + 5—4 
System 

logging into for UETP * 9-1, 9-3 

resource requirements for UETP * 9-1, 9-3 
System disk 

checking amount of free space ons 3-2 

free space required for upgrade» 5—4 

space needed to decompress libraries * 3-2 

space requirements for UETP > 9-4 

test error during UETP * 9-21, 9-22 

UETP test image» 9-31 

UETP test of» 9-30 

using DECW$TAILOR to customize+ 3-4, 8-9, 

F—1 

using VMSTAILOR to customize + 3-3, 8-8 
System hang 7-12, 9-18, 9-26 
SYSTEST account 

logging into for UETP * 9-1, 9-3 

privileges required for UETP * 9-20 

quotas required for UETP * 9—20 
SYSTEST directory 

creating for UETP + 9-5 

function during UETP + 9-3 
SYSTEST_CLIG account 

reenabling for UETP + 9-8 

requirements for UETP * 9-8, 9-35 
SYSUAF.DAT 

restoring after upgrade» 8—1 
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index 
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Tailored system disk 


See VMSTAILOR 
Tape cartridge drive 
preparing for UETP + 9-6 
Target-drive 
definition» 2-1, 7—1 
TCP/IP software 
use with DECwindows« 10-6 
Terminal 
preparing for UETP * 9~2, 9-4, 9-6, 9-11 
simulating users for UETP * 9-31 
test of 9-28 
UETP output» 9-30 
UETP test image+ 9-31 
UETP test of» 9-30 


U 


UETCONTOO.DAT file» 9-28 

creation of * 9-28 
UETINIDEV.DAT file > 9-28, 9-29 

creation of > 9-28 

format * 9-29, 9-30 
UETININET.DAT * 9-33 
UETININET.DAT file > 9-33 
UETINITOO.EXE image * 9-28 
UETINITO1.EXE image * 9-18, 9-28 
UETLOADOO.DAT « 9-31 
UETNETSOO.EXE + 9-33 
UETP 

See User Environment Test Package 
UETP$NODE_ADDRESS logical name + 9-10 
UETP.COM file + 9-27 

termination of * 9-13 
UETP.LOG file * 9-12, 9-17, 9-25, 9-32 
UETPHASOO.EXE program * 9-27, 9-28 
UETUNASO00.EXE UETP.test image» 9-16 
UIC 

See User Identification Code 
UPDATE_CLUSTER_MEMBERS.COM 

running * 8—4 
Upgrade procedure 

definition» 1-2 

Phase 2° 7-8 

Phase 3° 7-9 

Phase 4* 7—10 





Index—4 


Upgrade procedure (cont’d.) 
Phase 5° 7-10 
Phase 6¢ 7-11 
restrictions * 1-2 

User disk 
preparing for UETP* 9-1, 9-5 
space requirements for UETP* 9-4 
test error during UETP * 9-21 
UETP test image» 9-31 
UETP test of» 9~30 

User Environment Test Package (UETP) 
aborting execution of * 9-13 
description of * 9-1 
displaying tests as they run* 9-15 
initialization phase * 9-28 
interpreting output of 9-14 
master command procedure * 9-27 
normal completion of * 9-12 
organization of * 9-27 
required privileges * 9-20 
required quotas * 9-20 
requirements for small disk systems « 9—9 
running all phases of* 9-2 | 
running individual phase of* 9-11 
running multiple passes of * 9-11, 9-17 
starting * 9-10 
typical failures reported by * 9-18 
when to runs 3-2, 8-8 

User files 
processed during upgrade « 7-9 

User Identification Code (UIC) 
for UETP* 9-5 

User load 
defined for UETP DECnet—VAX test» 9-33 
defining for the UETP load test» 9-12 
equation used to determine for UETP load test « 

9-16 





V 


VAXcluster environment 
building > 3-2 
preparing for UETP* 9-9 
registering the VMS license * 3-1 
test failure during UETP * 9-23 
VAXcluster upgrade 


See Concurrent upgrade 


See Rolling upgrade 
VAXVMSSYS.PAR parameter files 
conversion» 7—11 


VMS DECwindows software 
choosing options during an installations 2-8, 7-6 
compiling Ada software + 10-9 
components» 2-9, 7—/ 
customizing * 10-1 
customizing the servers 10-3 
installation of 2-9, 7-7 
installing with DECW$TAILOR « F-1 
logical names« 10~2 
startings 10-1 
transports « 10-6 
VMSINSTAL 
invoke for upgrade « 7—1 
VMS license « 3-1 
VMSTAILOR 
adding files to a system disk* 8-8 
removing files from a system disks 3-3, 8-8 


index 


VMS/ULTRIX Connection software (UCX) 
functions 10-6 

VMS version required, for upgrade * 4—1 

Volume label + 2--7 

Volume Shadowing 
registering the license» 3—1 

VOTES parameter 
checking for rolling upgrade * 6-2 
setting for concurrent upgrade * 6-2 
upgrade requirement* 6-2 


W 


Workstation 
customizing * 10-3 
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How to Order Additional Documentation 





Technical Support 


If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 


your electronic, telephone, or direct mail order. 


Electronic Orders 


To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using a 1200- or 2400-baud 
modem. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Your Location Call 
Continental USA, 800-DIGITAL 
Alaska, or Hawaii 

Puerto Rico 809-754-7575 
Canada 800-267-6215 
International 

Internal? 


Contact 


Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, New Hampshire 03061 


Local Digital subsidiary 

Digital Equipment of Canada 

Attn: DECdirect Operations KAO2/2 
P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 
Local Digital subsidiary or 

approved distributor 


SSB Order Processing - WMO/E15 
or 
Software Supply Business 


Digital Equipment Corporation 
Westminster, Massachusetts 01473 


1¥or internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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